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PREFACE 



This manual is about the ATARI Personal Computer System. It covers both 
the ATARI 400" and the ATARI 800" computers. These two computers are 
electrically identical, differing only in mechanical features such as the 
keyboards and cartridge slots. The purpose of this manual is to explain In 
detail how to use all the features of the ATARI Personal Computer System. 
This Is a complex and powerful machine, and the explanations are accordingly 
rather long. Furthermore, they demand some expertise on the part of the 
reader. This book Is not intended for the beginning programmer. The reader 
should be thoroughly familiar with the BASIC Reference Manual provided with 
the computer. Familiarity with assembly language Is also essential. A 
Glossary in the back defines and explains some of the less commonly 
encountered jargon. However, this glossary does not Include terms that every 
serious personal computer programmer should already know. 

This book was written as a training manual for professional programmers 
wishing to use the ATARI Personal Computer System. At some later date it may 
be modified for general use. It does not supplant the tecnnical reference 
manual (ATARI part number C016555). That manual Is a reference manual; it is 
very useful for programmers who already understand the system. This book Is 
intended to be a tutorial; it will explain ideas and possibilities rather 
than define registers and control codes. 

The Software Development Suoport Group wrote this book. Chris Crawford 
wrote chapters 1 through 6 and Appendix I. Lane Winner wrote chapter 7 and 
Appendices III and IV with assistance from Jim Cox. Mike Ekberg wrote 
chapters 8 and 9 with assistance from John Eckstrom. Kathleen Armstrong 
wrote Appendix II. Gus Makreas prepared the glossary and table of contents. 
The final result has many flaws, but we are proud of it. 







CHAPTER 1 
SYSTEM OVERVIEW 



The ATARI Personal Computer System Is a second generation persona! 
computer. First and foremost, it Is a consumer computer. The thrust of the 
design is to make the consumer comfortable with the computer. This consumer 
orientation manifests Itself in many ways. First, the machine Is 
idiot-proofed; the consumer is protected from mistakes by such things as 
polarized connectors that will not go In the wrong way, a power interlock on 
the lid to the internal electronics, and a pair of plastic shields protecting 
the SYSTEM RESET key. Second, the machine has a great deal of graphics power; 
people respond to pictures much more readily than to text. Third, the machine 
has strong sound capabilities; again, people respond to direct sensory input 
better than to indirect textual messages. Finally, the computer has joysticks 
and paddles for more direct tactile Input than is possible with keyboards. 
The point here is not that the computer has lots of features but rather that 
the features are all part of a consistent design philosophy aimed directly at 
the consumer. The designer who does not appreciate this fundamental fact will 
find himself working against the grain of the system. 

The internal layout of the ATARI 400/800 w computer is very different 
from other systems. It of course has a microprocessor (a 6502), RAM, ROM, 
and a PIA. However, it also has three special purpose LSI chips known as 
ANTIC, POKEY, and CTIA. These chips were designed by Atari engineers 
primarily to take much of the burden of housekeeping off of the 6502, thereby 
freeing the 6502 to concentrate on computations. While they were at it, they 
designed a great deal of power into these chips. Each of these chips is 
almost as big (in terms of silicon area) as a 6502, so the three of them 
together provide a tremendous amount of power. Mastering the ATARI 400/800 
is primarily a matter of mastering these three chips. 

ANTIC is a microprocessor dedicated to the television display. It Is a 
true microprocessor; it has an instruction set, a program (called the display 
list), and data. The display list and the display data are written into RAM 
by the 6502. ANTIC retrieves this Information from RAM using DMA. It 
processes the higher level Instructions In the display list and translates 
these instructions into a real-time stream of simple instructions to CTIA. 

CTIA is a television interface chip. ANTIC directly controls most of 
CTlA's operations, but the 6502 can be programmed to intercede and control 
some or all of CTlA T s functions. CTIA converts the digital commands from 
ANTIC (or the 6502) Into the signal that goes to the television. CTIA also 
adds some factors of its own, such as color values, player-missile graphics, 
and collision detection. 

POKEY is a digital I/O chip. It handles such disparate tasks as the 
serial 1/0 bus, audio generation, keyboard scan, and random number 
generation. It also digitizes the resistive paddle Inputs and controls 
maskable Interrupt (IRQ) requests from peripherals. 

All four of these LSI chips function simultaneously. Careful separation 
of their functions In the design phase has minimized conflicts between the 
chips. The only hardware level conflict between any two chips in the system 
occurs when ANTIC needs to use the address and data busses to fetch Its 
display information. To do this, It halts the 6502 and takes control of the 
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busses* 

As with all 6502 systems, the I/O Is memory-mapped. Figure 1.1 presents 
the coarse memory map for the computer. Figure 1.2 shows the hardware 
arrangement. 
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Figure 1 .1 
Coarse Memory Map for ATARI 400/300 
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CHAPTER 2 
ANTIC AND THE DISPLAY LIST 

In order to understand the graphics capabilities of the Ataw Personal 
Computer System one must first understand the rudiments of how a television 
set works. Television sets use what is called a raster scan display system. 
An electron beam is generated at the rear of the television tube and shot 
toward the television screen. Along the way, it passes between sets of 
horizontal and vertical coils which, if energized, can deflect the beam. In 
this way the beam can be made to strike any point on the screen. The 
electronics Inside the television set cause the beam to sweep across the 
television screen In a regular fashion. The beam's Intensity can also be 
controlled. If you make the beam more intense the spot In the screen that It 
strikes will glow brightly; If you make It less Intense the spot will glow 
dimly or not at all. 

The beam starts at the top left corner of the screen and traces 
horizontally across the screen. As it sweeps across the screen, its intensity 
chances will paint an image on the screen. When It reaches the right edge of 
the screen, it Is turned off and brought back to left side of the screen. At 
the same time it Is moved down just a notch. It then turns back on and sweeps 
across the screen again. This process Is repeated for a total of 262 sweeps 
across the screen. (There are actually 525 sweeps across the screen In an 
alternating system known as interlace. We will Ignore interlace and act as if 
the television has only 262 lines.) These 262 lines fill the screen from top 
to bottom. At the bottom of the screen (after the 262nd line is drawn), the 
electron beam is turned off and returned to the upper left corner of the 
screen. Then It starts the cycle all over again. This entire cycle happens 60 
times every second. 

Now for some jargon: a single trace of the beam across the screen Is 
called a 'horizontal scan line 1 . A horizontal scan line Is the fundamental 
unit of meausurement of vertical distance on the screen. You state the height 
of an image by specifying the number of horizontal scan lines it spans. The 
period during which the beam returns from the right edge to the left edge is 
called the 'horizontal blank 1 . The period during which the beam returns to 
the top of the screen Is called the 'vertical blank 1 . The entire process of 
drawing a screen takes 16,634 microseconds. The vertical blank period Is 
about 1400 microseconds. The horizontal blank takes 14 microseconds. A single 
horizontal line takes 64 microseconds. 

Most television sets are designed with 'overscan 1 ; that means that they 
spread the image out so that the edges of the picture are off the edge of the 
television tube. This guarantees that you have no unsightly borders In your 
TV picture. It is very bad for computers, though, because screen Information 
that Is off the edge of the picture does you no good. For this reason the 
picture that the computer puts out must be somewhat smaller than what the 
television can theoretically display. For this reason only 192 horizontal 
scan lines are normally used by the Atari display. Thus, the normal limit of 
resolution of a television set used with the *W< is 192 pixels vertically. 
(Of course, a color monitor can do much better than that.) The standard unit 
of horizontal distance is the 'color clock'. You specify the width of an 
Imaae by stating how many color clocks wide It Is. There are 22S color clocks 
in a sinale horizontal scan line, of which a maximum of 176 are actually 
visible. Thus, the ultimate limit for full color horizontal resolurion with a 
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The Apple video hardware Is smart enough to interpret a screen memory byte as 
either an 8-bit character (text mode), two 4-bit color nybbles (lo-res mode), 
or 7 Individual bits for a bit map (hi -res mode). 

The ATARI 400/800 display list system represents a generalization of 
these systems. Where PET and TRS-80 have one mode and Apple has three modes, 
the ATARI 400/800 has 14 modes. The second Important difference Is that ATARI 
400/800 display modes can be mixed on the screen. That Is, the user Is not 
restricted to a choice between a screenful of text or a screenful of 
graphics. Any collection of the 14 graphics modes can be displayed on the 
screen. The third important difference is that the ATARI 400/800 screen RAM 
can be located anywhere In the address space of the computer and moved around 
while the program is running, while the other machines use fixed screen RAM 
areas. 

All of this generality is made possible by a video m icroorocessor called 
ANTIC. Where the earlier systems used rather simple video circuitry, Atari 
designed a full-scale microprocessor just to handle the intracacies of the 
television display. ANTIC is a true microprocessor; It has an instruction 
set, a program, and data. The program for ANTIC is called the display list. 
The display list specifies three things: where the screen data may be found, 
what display modes to use to Interpret the screen data, and what special 
display options (If any) should be implemented. When using the display list, 
It is important to shed the old view of a screen as a homogeneous Image In a 
single mode and see it Instead as a stack of f mode lines 1 . A mode line Is a 
collection of horizontal scan tines. It streches horizontally all the way 
across the screen. A Graphics 2 mode line Is 16 horizontal scan lines high, 
while a Graphics 7 mode line Is only two scan lines high. Many Graphics modes 
available from BASIC are homogeneous; an entire screen of a single mode Is 
set up. One must not limit her imagination to this pattern; with the display 
list you can create any sequence of mode lines down the screen. The display 
list Is a collection of code bytes which specify that sequence. 

ANTI C f S instruction set is rather simple. There are four classes of 
Instructions: map mode Instructions, character mode instructions, blank line 
instructions, and jump Instructions. Map mode Instructions cause ANTIC to 
display a mode line with simple colored pixels (no characters). Character 
mode instructions cause ANTIC to display a mode line with characters In it. 
Blank line Instructions cause ANTIC to display a number of horizontal scan 
lines with solid background color. Jump Instructions are analogous to a 6502 
JMP instruction; they^reload ANTIC 1 s program counter. There are also four 
special options that can sometimes be specified by setting a designated bit 
In the ANTIC instruction. These options are: display list Interrupt (DL1), 
load memory scan (LMS), vertical scroll, and horizontal scroll. 

Map mode Instructions cause ANTIC to display a mode line containing 
pixels with solid color In them. The color displayed comes from a color 
register. The choice of color register Is specified by the value of the 
screen data. In foui — color map modes (BASIC modes 3, 5, and 7, and ANTIC 
modes 8, A, D, and E) , a pair' of bits Is required to specify a color: 
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va I ue of bit 

00 0 
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10 2 

11 3 
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color register 
COLBAK 
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C0LPF1 
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used 



Since only two bits are needed to specify one pixel, 4 pixels are encoded In 
each screen data byte. For example, a byte of screen data containing the 
value S1B would display four pixels; the first would be the background, the 
second would be color register 0, the third would be color register 1, and 
the fourth would be color register 2: 

$18 = 0001101 1 55 00 01 10 1 1 

In two-color map modes (BASIC modes 4, 6, and 8, and ANTIC modes 9, B, C, and 
F) each bit specifies one of two color registers. A bit value of 0 selects 
background color for the pixel and a bit value of 1 selects color register 0 
for the pixel. Eight pixels can be stored in one screen data byte. 

There are eight different map display modes. They differ in the number 
of colors they display (2 vs 4), the vertical size one mode line occupies (1 
scan line, 2, 4, or 8), and the number of pixels that fit horizontally into 
one mode line (40, 30, 160, or 320). Thus, some map modes give better 
resolution; these will of course require more screen RAM. Figure ^.1 presents 
this Information for all modes: 
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Figure 2.1 
ANTIC mode line requirements 
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Character mode Instructions cause ANTIC to display a mode line with 
characters in It. Each byte in screen RAM specifies one character. There are 
six character display modes. Character displays are discussed In Chapter 4. 

Blank line Instructions produce blank lines with solid background color. 
There are eight blank line Instructions; they specify skipping one through 
eight blank I ines. 

There are two jump instructions. The first (JMP) is a direct jump; It 
reloads ANTlC's program counter with a new address which follows the JMP 
instruction as an operand. Its only function is to provide a solution to a 
tricky problem: ANTIC'S program counter Is only ten bits wide and so cannot 
cross a IK boundary. If the display list must cross a 1K boundary then It 
must use a JMP instruction to hop over the boundary. Note that this means 
that dispiay lists are not fully relocatable. 

The second jump instruction (JVB) is more commonly used. It reloads the 
program counter with the value In the operand and waits for the television to 
perform a vertical blank. This instruction is normally used to terminate a 
display list by jumping back up to the top of the display list. Jumping up to 
the top of the display list turns It Into an Infinite loop; waiting for 
vertical blank Insures that the infinite loop Is synchronized to the display 
cycle of the television. Both JMP and JVB are three byte instructions; the 
first byte is the opcode, the second and third bytes are the address to jump 
to (lo then hi). 

The four special options mentioned previously will be discussed In 
Chapters 5 and 6. The load memory scan (LMS) option must have a preliminary 
explanation. This option is selected by setting bit 6 of a map mode or a 
character mode instruction byte. When ANTIC encounters such an Instruction, 
It will load its memory scan counter with the following two bytes. This 
memory scan counter tells ANTIC where the screen RAM Is. It will begin 
fetching display data from this area. The LMS instruction is a three byte 
instruction: one byte opcode followed by two bytes of operand. In simple 
display lists the LMS Instruction is used only once, at the beginning of the 
display list. It may sometimes be necessary to use a second LMS Instruction. 
The need arises when the screen RAM area crosses a 4K boundary. The memory 
scan counter is only 12 bits wide and so cannot cross a 4K boundary, in this 
case an LMS instruction must be used to jump the memory scan counter over the 
boundary. Note that this means that display data Is not fully relocatable. 
LMS instructions have wider uses which will be discussed later. 

BUILDING DISPLAY LISTS 

Every dispiay list should start off with 3 f blank 8 lines 1 Instructions. 
This is to defeat vertical overscan by bringing the beginning of the display 
24 scan lines down. After this is done the first display line should be 
specified. Simultaneously, the LMS should be used to tell ANTIC where It will 
find the screen RAM. Then follows the display list proper, which lists the 
display bytes for the mode lines on the screen. The total numoer of 
horizontal scan lines produced by the display list should always be 192 or 
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less; ANTIC does not maintain the screen timing requirements of the 
television. If you give ANTIC too many scan lines to display it will do so, 
but the television screen will probably roll. Displaying fewer than 192 scan 
lines will cause no problems; indeed. It will decrease 6502 execution time by 
reducing the number of cycles stolen by ANTIC. The programmer must calculate 
the sum of the horizontal scan lines produced by her display list and verify 
it herself. The display list terminates with a JVB Instruction. Here is a 
typical display list for a standard BASIC Graphics mode 0 display (all values 
are in hexadecimal): 

70 blank 8 I ines 
70 blank 8 I ines 
70 b I ank 8 I Ines 

42 display ANTIC mode 2 (BASIC mode 0) 
20 also, screen memory starts at 7C20 
7C 

02 display ANTIC mode 2 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

02 

41 jump and wait for vertical blank 
£0 to display list which starts at 
7B S73E0 



As you can see, this display list is short only 32 bytes. Most 

display lists are less than 100 bytes long. Furthermore, they are quite 
simple In structure and easy to set up. 

To implement your own display list you must first design the display 
format. This Is best done on paper. Lay out the screen image and translate 
it into a sequence of mode lines. Keep track of the scan line count of your 
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display by looking up the scan line requirements of the various modes in 
Figure 2.1 • Translate the sequence of mode lines into a sequence of ANTIC 
mode bytes. Put three 'blank 8 lines 1 bytes ($70) at the top of the list. 
Set bit 6 of the first display byte (that is, make the upper nybble a 4). 
This makes a load memory scan command. Follow with two bytes which specify 
the address of the screen RAM (lo then hi). Then follow with the rest of the 
display bytes. At the end of your display list put In the JVB Instruction 
($41) and the address of the top of the display list. Now store all of these 
bytes Into RAM. They can be anywhere you want; just make sure they don f t 
overlay something else and your JVB points to the top of the display list. 
The display list must not cross a 1K address boundary. If you absolutely 
must have It cross such a boundary, Insert a JMP Instruction just In front 
of the boundary. The JMP Instruction's operand Is the address of the first 
byte on the other side of the boundary. Next you must turn off ANTIC for a 
fraction of a second while you rewrite Its display list pointer. Do this by 
writing a 0 into SDMCTL at location S22F. Then store the address of the new 
dlsolay list Into $230 and $231 (lo then hi). Lastly, turn ANTIC back on 
with a $22 Into SDMCTL. During the vertical blank, while ANTIC is quiet, the 
operating system will reload ANTIC'S program counter with these values. 

Screen memory can be placed anywhere In the address space of the 
computer. Normally the display list specifies the beginning of the screen 

memory with the first display instruction the initial LMS Instruction. 

However, ANTIC can execute a new LMS instruction with each display line of 
the display list If this Is desired, in this way information from all over 
the address space of the computer can be displayed on a single screen. This 
can be of value in setting up Independent text windows. 

There are several restrictions In your placement of the screen memory. 
First, screen memory cannot cross a 4K address boundary. If you cannot avoid 
crossing a 4K boundary (as would be the case in BASIC mode 8, which uses 8K 
of RAM) you must reload the memory scan counter with a new LMS Instruction. 
Second, tf you wish to use any of the operating system screen routines you 
must abide by the conventions the OS uses. This can be particularly 
difficult when using a modified display list In a BASIC program, if you 
alter a standard display list from a BASIC program and then attempt to PRINT 
or PLOT to the screen, the OS will do so under the assumption that the 
display list is unchanged. This will probably result In a garbled display. 

There are three ways the display can fall when you attempt this. First, 
BASIC may refuse to carry out a screen operation because it Is Impossible to 
do with the Graphics mode that the OS thinks It Is In. The OS stores the 
value of the Graphics mode that it thinks is on the screen in address $57. 
You can fool the OS into cooperating by POKEIng a different value there. 
POKE the BASIC mode number, not the ANTIC mode number. 

The second failure you might get arises when you mix mode lines with 
different screen memory byte requirements. Some mode lines require 40 bytes 
per line, some require 20 bytes per line, and some require only 10 bytes per 
line. Let's say that you insert one 20 byte mode line into 3 display list 
with 40 byte mode lines. Then you PRINT text to the display. Everything 
above the Interloper line is fine, but below It the characters are shifted 
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20 spaces to the right. This Is because the operating system assumed that 
each line would require 40 bytes and positioned the characters accordingly. 
But ANTIC, when It encountered the Interloper line, took only twenty bytes 
of what the OS thought should be a 40-byte line. ANTIC Interpreted the other 
20 bytes as belonging to the next line, and displayed them there. This 
resulted In the next line and all later lines being shifted 20 spaces to the 
right. 

The only absolute way around this problem Is to refrain from using 
BASIC PRINTS and PLOTs to output to a mixed display list screen. The quick 
and dirty solution Is to organize the screen Into line groups which contain 
integer multiples of the standard byte requirement. That Is, do not Insert a 
20-byte mode line Into a 40-byte display; instead Insert two 20-byte lines 
or one 20-byte line and two 10-byte lines. So long as you retain the proper 
Integer multiples the horizontal shift will be avoided. 

This solution accentuates the third problem with mixed display lists 
and BASIC: vertical shifts. The OS positions screen material vertically by 
calculating the number of bytes to skip down from the top of the screen, in 
a standard 40-byte line display, BASIC would position the characters onto 
the tenth line by skipping 360 bytes from the beginning. If you have 
inserted four 10-byte lines then BASIC will end up three lines further down 
the screen than you would otherwise expect. Furthermore, different mode 
lines consume different numbers of scan lines, so the position on the screen 
will not be quite what you expected if you do not take scan line costs into 
account. 

As you can see, mixed mode displays can be difficult to use in 
conjunction with the OS. Often you must fool the operating system to make 
such displays work. To PRINT or PLOT to a mode window, POKE the BASIC mode 
number of that window to address 87, then POKE the address of the top left 
pixel of the mode window Into locations 88 and 89 (lo then hi). In character 
modes, execute a POSITION 0,0 to heme the cursor to the top left corner of 
the mode window. In map modes, ail PLOTs and DRAWTOs will be made using the 
top left corner of the mode window as the origin of the coordinate system. 

The display list system can be used to produce appealing screen 
displays. Its most obvious use is for mixing text and graphics. For example, 
you could prepare a screen with a bold BASIC mode 2 title, a medium size 
BASIC mode 1 subtitle, and small BASIC mode 0 fine print. You could then 
throw In a BASIC mode 8 picture In the middle with some more text at the 
bottom. A good example of this technique Is provided by the display In the 
States and Capitals program. 

The aforementioned problems will discourage the extensive use of such 
techniques from BASIC. With assembly language routines modified display 
lists are best used by organizing the screen Into a series of windows, each 
window having Its own LMS instruction and its own Independent RAM area. 

One simple application of display list modifications Is to vertically 
space lines on the screen by inserting blank line bytes. This will add some 
vertical spacing which will highlight critical messages and enhance the 
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readability of some displays. 

Another important use of display list manipulations is In providing 
access to features not available from BASIC. There are three text modes 
supported by ANTIC that BASIC does not support. Only display list 
manipulations gain the user access to these modes. There are also display 
list Interrupt and fine scrolling capabilities that are only available after 
the display list Is modified. These features are the subjects of chapters 5 
and 6. 

Manipulations with the LMS instruction and Its operand offer many 
possibilities to the creative programmer. For example, by changing the LMS 
during vertical blank the programmer can alternate screen Images. This can 
be done at slow speed to change between predrawn displays without having to 
redraw each one. Each display would continue to reside In (and consume) RAM 
even while It is not In use, but It would be available almost Instantly. 
This technique can also be used for animation. By flipping through a 
sequence of displays, cyclic animation can be achieved. The program to do 
this would manipulate only two address bytes to display many thousands of 
bytes of RAM. 

It is also possible to superimpose Images by flipping screens at high 
speed. The human eye has a time resolution of about 1/16th of a second, so a 
program can cycle between four Images, one every 1/60th of a second, so that 
each repeats every 1/15th of a second. In this way, up to four images can 
appear to reside simultaneously on the screen. Of course, there are some 
drawbacks to this method. First, four separate displays may well cost a lot 
of RAM. Second, each display image will be washed out because It only shows 
up one quarter of the time. This means that the background of ail displays 
must be black, and each image must be bright. Furthermore, there will be 
some unpleasant screen flicker when this technique Is used. A conservative 
programmer might consider cycling between only three or even only two 
images. This technique can also be used to extend the color and luminosity 
resolution of the computer. By cycling between four versions of the same 
image, each version stressing one color or luminosity range, a wider range 
of colors and luminosities Is availible. For example, suppose we wish to 
display a bar of many different luminances. We first set our four color 
registers to the values: 

background: 00 
playfield 1: 02 
playfield 2: OA 
playfield 3: 0C 
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Now we put the following Images Into each of the screen RAM areas 



first frame 
second frame 
third frame 
fourth frame 



pixel contents (by playfield color register) 
1 1 1. 1 2 3 2 3 2 3 2 3 

B111BB232323 
BB1 1BBBB2323 
BBB 1 BBBBBB23 



effective luminance x4 2 4 6 8 10 12 20 24 30 36 40 48 



percs i ved I urn I nance 




In this way much finer luminance resolution is possible. 

A final suagestion concerns a subject which is laden with OPPO^"" ' + 
but litte understood as yet: the dynamic display list Th.s Is a display 
list which the 6502 changes during vertical blank periods, " should be 
possible to produce interesting effects with dynamic display lists. For 
~amr.ll a text editing program dynamically inserts blank lines above and 
betcwlhe screen ? ne be ng 9 edi ted to set it apart from the other lines of 
tex?! As the cursor is moved vertically, the display list is changed. The 
technique Is odd but very effective. 
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CHAPTER 3 
GRAPHICS INDIRECTION 
(COLOR REGISTERS AND CHARACTER SETS) 

Indirection is a powerful concept In computing but a difficult one for the 
beginning programmer to appreciate. In 6502 assembly language there are three 
levels of Indirection In referring to numbers. The first and most direct 
level Is the Immediate addressing mode In which the number Itself Is directly 
stated: 

LDA #SF4 

The second level of Indirection Is reached when the program refers to a 
memory location that holds the number: 

LDA $0602 

The third and highest level of Indirection with the 6502 Is attained when the 
program refers to a pair of memory locations which together contain the 
address of the memory location which holds the number. In the 6502, this 
Indirection Is complicated by the addition of an Index: 

LDA ($00), Y 

Indirection provides a greater degree of generality (and hence power) to the 
programmer. Instead of trucking out the same old numbers every time she wants 
to get something done, the programmer can simply point to them. By changing 
the pointer, she can change the behavior of the program. Indirection Is 
obviously an important capability. 

Graphics Indirection Is built Into the ATARI Personal Computer System In 
two ways: with color registers and with character sets. Programmers first 
approaching this computer after programming other systems often think In 
terms of direct colors. A color register Is a more complex beast than a 
color. A color specifies a permanent value. A color register Is Indirect; It 
holds any color value. The difference between the two Is analogous to the 
difference between a box-end wrench and a socket wrench ♦ The box-end wrench 
comes In one size only but a socket wrench can hold almost any size socket. A 
socket wrench is more flexible but takes a little more skill to utilize 
properly. Similarly, a color register is more flexible than a color but takes 
mere skill to use effectively. 

There are nine color registers In the ATARI 400/800; four are for 
player-missile graphics and will be discussed In Chapter 4. The remaining 
five are not always used; depending on the graphics mode used as few as 2 
registers or as many as 5 will show up on the screen. In EASIC mode 0 only 
one and one-half registers are used because the hue value of the characters 
Is ignored; characters take the same hue as playfield register 2 but take 
their luminosity from register 1. The color registers are in CT1A at 
addresses 5D016 through SD01A. They are 'shadowed' from OS RAM locations into 
CTIA during vertical blank. Ftgur© 3.1 gives color register shadow and 
hardware addresses. 
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IMAGE 
CONTROLLED 
player 0 
player 1 
player 2 
p I ayer 3 
playfleld 0 
playfleld 1 
playfleld 2 
playfleld 3 
background 



HARDWARE 



OS SHADOW 



1 A DC 1 

LABEL 


annRPSS 


COLrMU 


uu t *- 


COLPM1 


D013 


C0LPM2 


D014 


C0LPM3 


D015 


COLPFO 


D016 


COLPF1 


D017 


C0LPF2 


D018 


C0LPF3 


0019 


COLBK 


D01A 


Figure 3.1 



LABEL 


ADORESS 


PCOLRO 


2C0 


PC0LR1 


2C1 


PC0LR2 


2C2 


PC0LR3 


2C3 


C0L0R0 


2C4 


COLOR 1 


2C5 


C0L0R2 


2C5 


C0L0R3 


2C7 


C0L0R4 


2C3 



Per most purposes, the ^°^ c ^ 

the shadow locations. ™^dresses . i Irtt and most common is the 
write directly to the CTI A a ddI * ess ®J' ' PV , Chapter 5. The second 
display list Interrupt whlc » will be taken up Chap 

arises when the user disables _ he QS^ert ca MM +s are +he subJe ct 

move the shadow values Into CTI A. YerT.cai 
of Appendix I . 



la. The upper 
parameter of 
Manual lists 
I umi ncs I ty 
the BASIC 
s Ign i f leant, 
total of 128 
n this book, 



Colors are encoded In a color register by a simple formu 
nybble gives the hue value, which is Iden tlcal second 
the BASIC SETCOLOR command. Table 9.3 of the BASIC Reference 

SETCOLOR FluTl^ crT Jit of nt. ^ .J»t 

ts,^ there are eight luminosities for each hue. Tnere are a 
2 ors from STch £ choose (8 luminosities «^ « ' 
the term 'color' denotes a hue- luminosity combination. 

Once a color is encoded into a color register It Is mapped onto the 
screen by referring to the color «Ql«t«^«t Jo^ It. « wh ich 

modes which support four color ^f' s t^ S sc h 4^ C lf nC e there are four color 
color register Is to be mapped onto the *«^ e Th e2Ch screen data 

^JIM^K SySS * a h,K! r of b!+s specmes 

which color register provides the color for That pixel. 

,„ text display .odes (BASICS GRAPHICS -djj ' £ U°Sf °* 

SXTS^r-i; r.T4 Y Mn^ „ .h y these t,e 
modes have only 64 characters available. 

Color register indirection gives the .^f ^^^^i col0 rs for 
al 1 .^: S^:.^ P KTT^ most nearly meets 

his needs. 
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Second, the programmer can manipulate the color registers In real time 
to produce pretty effects . The simplest version of this Is demonstrated by 
the fol lowing BASIC I Ine: 

FOR 1=0 TO 254 STEP 2: POKE 712,I:NEXT1 

This line simply cycles the border color through all possible colors. The 
effect Is quite pleasing and certainly grabs attention. The fundamental 
technique can be extended In a variety of ways. A special variation of this 
Is to create simple cyclic animation by drawing a figure in four colors and 
then cycling the colors through the color registers rather than redrawing 
the figure. The following program Illustrates the Idea: 



10 GRAPHICS 23 

20 FOR X=0 TO 39 

30 FOR l*0 TO 3 

40 COLOR I 

50 PLOT 4*X+i,0 

60 DRAWT0 4*X+I ,95 

70 NEXT I 

80 NEXT X 

90 A=PEEK(712) 

100 POKE 712,PEEK(710) 

110 POKE 710,PEEK(709) 

120 POKE 709,PEEKC708) 

130 POKE 708, A 

140 GOTO 90 



The third application of color registers Is to logically key colors to 
situations. For example, a paged menu system can be made more understandable 
by changing the background color or the border color for each page In the 
menu. Perhaps the screen could flash red when an Illegal key Is pressed. The 
use of the color characters available In BASIC Graphics modes 1 and 2 can 
greatly extend the impact of textual material. An account sum could be shown 
in red If the account' is In the red, or black If the account is In the 
black. Words or phrases of import can be shewn In special colors to make 
them stand out. The use of colors In map modes (no text) can also improve 
the utility of such graphics. A single graphics image (a monster, a boat, or 
whatever) could be presented In several different colors to represent 
several different versions of the same thing. It costs a great deal of RAM 
to store an image, but It costs very little to change the color of an 
existing [mage. For example, It would be much easier to show three different 
boats by presenting one boat shape In three different colors than three 
different boat shapes. 

The fourth and most important application of color registers is 
utilized with display list interrupts. A single color register can be used 
to put up to 128 colors onto a single screen. This very Important capability 
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will be discussed In Chapter 5. 
CHARACTER SETS 

This fs^he "ostlimelconLmlng'step. Each character Is displayed on 
thl'screen on an 8x8 grid; It Is encoded In mercery as an 8-byte table. 
Figure 3.2 depicts the encoding arrangement. 



character image 




binary representation 
00000000 
00011000 
0011 1100 
01100110 

01100110 

01111110 
01 100110 
00000000 



hex representation 
00 
18 
3C 
66 
66 

7E 
66 
00 



Figure 3.2 
character encoding 



A full character set has 128 characters in It, each with a normal and 
an inverse video Incarnation. Such a charac ter seT needs 1024^y+ m o t spac 

character^ is a big Job. Fortunately, tbere are software packages on ,n. 
market to make this job easier . 

^ rSa „ r+sr c e + is defined and placed into RAW, you must tell 

character sets Is to print the character you want onto the screen . 
Sis'cai; begone directly from BASIC with simple PRINTs or by writing 
numbers dtrectly Into the screen memory. 

A soeclal capability of the system not supported In BASIC the 
a Single character. This can be a serious hindrance when us.ng characrer 
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graphics. There are two other text modes designed especially for character 
graphics. They are ANTIC modes 4 and 5. Each character In these modes Is 
only four pixels wide, but each pixel can have four colors (counting 
background). The characters are defined just like BASIC Graphics mode 0 
characters, except that each pixel Is twice as wide and has two bits 
assigned to It to specify the color register used. Unlike ANTIC modes 6 and 
7 (BASIC modes 1 and 2), color register selection Is not made by the 
character name byte but Instead by the defined character set. Each byte In 
the character table Is broken Into four bit pairs, each of which selects the 
color for a pixel. (This Is why there are only four horizontal pixels per 
character.) The highest bit (D7) of the character name byte modifies the 
color register used. Color register selection Is made according to Figure 
3.3: 

bit pair In D7 = 0 D7 » 1 

character defn 

00 COLBAK COLBAK 

01 PFO PFO 

10 PF1 PF1 

1 1 PF2 PF3 

Figure 3.3 
color register selection for 



Using these text modes, multicolored graphics characters can be put 
onto the screen. 

Another Interesting ANTIC character mode Is the lowercase descenders 
mode (ANTIC mode 3). This mode displays 10 scan lines per mode line, but 
since characters use only 8 bytes vertically, the lower two scan lines are 
normally left empty. If a character in the last quarter of the character set 
Is displayed, the top two scan lines of the character will be left empty; 
the dara that should have been displayed there will Instead be shown on the 
bottom two lines. This allows the user to create lowercase characters with 
descenders . 

Many interesting and useful application possibilities spring from 
character set Indirection* The obvious application Is the modified font. A 
different font can give a program a unique appearance. It Is possible to 
have Greek, Cyrillic, or other special character sets. Going one step 
further, one can create graphics fonts. The ENERGY CZAR* computer program 
uses a redefined character set for bar graphs. A character occupies eight 
pixels; this means that bar charts Implemented with standard characters have 
a resolution of eight pixels, a rather poor resolution. ENERGY CZAR uses a 
special character set In which some of the less popular text symbols 
(ampersands, pound signs, etc) have been replaced with special bar chart 
characters. One character is a one-pixei bar, another is a twc-pixei bar, 
and so on to the full eight-pixel bar. The program can thus draw detailed 
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bar charts with resolution of a single pixel. Figure 3.4 shows a typical 
display from this program. The mix of text with map graphics Is only 
apparent; the entire display Is constructed with characrers. 
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Figure 3,4 
ENERGY CZAR™ bar charts 



In many applications character sets can be created that show special 
Images. For example, by defining a terrain graphics character set with river 
characters, forest characters, mountain characters, and so forth, It Is 
possible to make a terrain map of any country. Indeed, with imagination a 
map of terrain on a different planet can just as easily be done. When doing 
this, It Is best to define five to eight characters for each terrain type. 
Each variation of a single type should be positioned slightly differently In 
the character pixel. By^mixing the different characters together it Is 
possible to avoid the monotonous look that is characteristic of primitive 
character graphics. Most people won't realize that the resulting map uses 
character graphics until they study the map closely. Figure 3.5 shows a 
display of a terrain map created with character set graphics. The 
reproduction In black and white does not do justice to the original display, 
which has up to 13 colors. 



* 
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I 



Figure 3.5 
terrain map with character set graphics 



One could create an electronics character set with transistor 
characters, diode characters, wire characters, and so forth to produce an 
electronics schematics program. Or one could create an architectural 
character set with doorway characters, wall characters, corner characters, 
and so on to make an architectural blueprint program. The graphics 
possibilities opened up by character graphics with personal computers have 
not been fully explored. 

Characters can be turned upside down by PCKEing a 4 into location 755. 
One possible application of this feature might be for displaying playing 
cards (as In a Blackjack game). The upper half of the card can be shown 
rlghtside up; with a display list Interrupt the characters can be turned 
upside down for the lower half of the card. This feature might also be of 
seme use In displaying Images with mirror reflections (reflection pools, 
I akes , etc) . 

Even more exciting possibilities spring to mind when one realizes that 
It is quite practical to change character sets while the program Is running. 
A character set costs either 512 bytes or 1024 bytes; In either case It is 
quite Inexpensive to keep multiple character sets In memory and flip between 
them during program execution. There are three time regimes for such 
character set multiplexing: human slow (more than 1 second); human fast 
(1/60+h second to 1 second); and machine fast (faster than 1/60th second). 
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Human slow character set multiplexing Is useful for 'change of scenery' 
work. For example, a space travel program might use one graphics character 
set for one planet, another set for space, and a third set for another 
planet. As the traveler changes locations, the program changes the character 
set to give exotic new scenery. An adventure-type program might change 
character sets as the player changes locales. 

Human fast character set multiplexing is primarily of value for 
animation. This can be done In two ways: changing characters within a single 
character set, and changing whole character sets. The SPACE INVADERS 
(trademark of Taito America Corp.) on the ATARI 400/800 uses the former 
technique. The Invaders are actually characters. By rapidly changing the 
characters, the programmer was able to animate them. This was easy because 
there are only six different monsters; each has 4 different Incarnations. 
High speed cyclic animation of an entire screen Is possible by setting up a 
number of character sets, drawing the screen image, and then simply cycling 
through the character sets. If each character has a slightly different 
incarnation in each of the character sets, that character will go through an 
animated sequence as the character sets are changed. In this way a screen 
full of objects could be made to cyclicly move with a very simple loop. Once 
the character set data Is in place and the screen has been drawn the code to 
animate the screen would be this simple: 



1000 FOR 1=1 TO 10 

1010 POKE 756,CHARBASE( I ) 

1020 NEXT I 

1030 GOTO 1000 



Computer fast character set animation Is used to put multiple character 
sets onto a single screen. This makes use of the display list Interrupt 
capability of the ccmouter. This topic will be addressed further In Chapter 
5. 

The use of character sets for graphics and animation has many 
advantages and seme limitations. The biggest advantage is that It costs very 
little RAM to produce detailed displays. A graphics display using BASIC mode 
2 characters (such as the one shown In Figure 3.5) can give as much detail 
and one more color than a BASIC mode 7 display, and yet the character image 
will cost 200 bytes while the map Image will cost 4000 bytes. The RAM cost 
for multiple character sets Is only 512 bytes per set, so It Is Inexpensive 
to have multiple character sets. Screen manipulations with character 
graphics are much faster because you have less data to manipulate. However, 
character graphics are not as flexible as map graphics. You cannot put 
anything you want anywhere on the screen. This limitation would preclude the 
use of character graphics in some applications. However, there remain many 
graphics applications for which the program need display only a limited 
number of predefl ned shapes in fixed locations. In these cases character 
graphics provide great utility. 
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CHAPTER 4 
PLAYER-MISSILE GRAPHICS 



Is an Important capability of any personal computer system, 
screen can greatly add to the excitement and realism of any 
nly animation Is crucial to the appeal of many computer games. 

an animated Image can convey Information with more Impact and 
static Image. It can draw attention to an Item or event of 
can directly show a dynamic process rather than Indirectly 
Animation must accordingly be regarded as an Important element 
capabilities of any computer system. 



The conventional way to effect animation with personal computers Is to 
move the Image data through the screen RAM area. This requires a two-step 
process. First, the program must erase the old Image by writing background 
values to the RAM containing the current Image. Then the program must write 
the image data to the RAM corresponding to the new position of the image. By 
repeating this process over and over, the Image will appear to move on the 
screen . 

There are two problems with this technique. First, If the animation is 
being done In a graphics mode with large pixels, the motion will not be 
smooth; the image will jerk across the screen. With other computers the only 
solution is to use a graphics mode with smaller pixels (higher resolution). 
The second problem is much worse. The screen Is a two-dimensional image but 
the screen RAM is organized one-d I mens tonal !y. This means that an Image which 
is contiguous on the screen will not be contiguous in the RAM. The 
discrepancy Is Illustrated In Figure 4.1. 
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00 00 00 
00 99 00 
00 BD 00 
00 FF 00 
00 BD 00 
00 99 00 
00 00 00 



spacing of bytes In RAM: 
00 00 00 00 99 00 00 BD 00 00 FF 00 00 BD 00 00 99 00 00 00 00 




Image bytes scattered through RAM 



Figure 4.1 
RAM tmages are not contiguous 



The significance of this discrepancy does not become obvious until you 
try to write a program to move such an image. Lock how the bytes that make 
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up the Image are scattered through the RAM. To erase them your program must 
calculate their addresses. This calculation Is not always easy to do. The 
assembly code Just to access a single screen byte at screen location 
(XP0S,YP0S) would look like this (this code assumes 40 bytes per screen 
I Ine): 



Address of beginning of screen RAM 

zero page pointer 

high order byte of address 

high order pointer 

temporary register 
vertical position 
times 2 

shift carry Into TEMPA+1 
t i mes 4 

sh ift carry again 
times 8 
shift again 

save YP0S*8 
Into TEMPB 
low byte 
t I mes 1 6 

times 32 



LDA SCRNRM 
STA POINTR 
LDA SCRNRM+1 
STA POINTR+1 
LDA #$00 
STA TEMPA+1 
LDA YPOS 
ASL A 

ROL TEMPA+t 
ASL A 

ROL TEMPA+1 
ASL A 

ROL TEMPA+1 
LDX TEMPA+1 
STX TEMPB+1 
STA TEMB 
ASL A 

ROL TEMPA+1 
ASL A 

ROL TEMPA+1 
CLC 

ADC TEMPB 
STA TEMPB 
LDA TEMPA+1 
ADC TEMPB+1 
STA TEMPB+1 
LDA TEMPB 
CLC 

ADC POINTR 
STA POINTR 
LDA TEMPB+1 
ADC POINTR+1 
STA POINTR+1 
LDY XPOS 
LDA (POINTR), Y 

Clearly, this code to access a screen location is too cumbersome. This 
Is certainly not the most elegant or fastest code to solve the problem; 
certainly a good programmer could take advantage of special circumstances to 
make the code mere compact or elegant. The point of this Is that accessing 
pixels on a screen takes a lot of computing. The above routine takes about 
100 machine cycles to access a single byte on the screen. To move an image 
that occupies, say, 50 by+es, would require 100 accesses or about 10,000 
machine cycles or roughly 10 milliseconds. This may not sound like much but 
If you want to achieve smooth motion you have to move the object every 17 
milliseconds. If there are other objects to move or any calculations to 



add in YPCS*8 to get YP0S*40 
now do high order byte 
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carry out there isn*t much processor time left to devote to them. What this 
all adds up to Is that this type of animation (called 'playfleld animation 1 ) 
Is too slow for many purposes. You can still get animation this way, but you 
are limited to few objects or small objects or slow motion or few 
calculations between motion. The trade-offs that a programmer must make In 
using such animation are too restrictive. 

The ATARI 400/800 solution to this problem Is p I ayer-tnl ss 1 1 e graphics. 
In order to understand pi ayer-mlss I le graphics, It Is Important to 
understand the essence of the problem of playfleld animation: the screen 
Image Is two-dimensional while the RAM Image Is one-d I mens Iona I . The 
solution was to create a graphics object which Is one-d Imens Iona I on the 
screen as well as one-d Imens Iona I In RAM. This object (called a player) 
appears In RAM as a table that Is either 128 or 256 bytes long. The table is 
mapped directly to the screen. It appears as a vertical band stretching from 
the top cf the screen to the bottom. Each byte In the table Is mapped Into 
either one or two horizontal scan lines, with the choice between the two 
made by the programmer. The screen image Is a simple bit-map of the data In 
the table. If a bit is on, then the corresponding pixel In the vertical 
column is lit; If the bit Is off, then the corresponding pixel Is off. Thus, 
the player Image is not strictly one-d Imens tonal ; It Is actually eight bits 
wide. 

Drawing a player Image on the screen Is quite simple. First you draw a 
picture of the desired Image on graph paper. This Image must be no more than 
8 pixels wide. Then you translate the image Into binary code, substituting 
ones for Illuminated pixels and zeros for empty ones. Then you translate the 
resulting binary number Into decimal or hexadecimal, depending on which is 
more convenient. Then you store zeros into the player RAM to clear the 
image. Next, store the image data Into the player RAM, with the byte at the 
top'of the player image going first, followed by the other Image bytes In 
top to bottom sequence. The further down in RAM you place the data, the 
lower the Image will appear on the screen. 

Animating this Image Is very easy. Vertical motion Is obtained by 
moving the Image data through the player RAM. This Is In principle the same 
method used In playfleld animation, but there Is a big difference In 
practice: the move routine for vertical motion Is a one-d Imens Iona I move 
Instead of a two-dimensional move. The program does not need to multiply by 
40 and It often does not need to use Indirection. It could be as simple as: 



LDX #$01 
LOOP LDA PLAYER, X 
DEX 

STA PLAYER, X 
I NX 

I MX 

BNE LCX)P 



This routine takes about 5 milliseconds to move the entire player, about 
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bytes where this one moves 256 bytes, '^ign spe 

can be tr I mmed to move on y the b ^ es ab ^f ^ilfoo^l^seconds . The 

'^J?t*V^ l%\ol Tth'plfyers .. both simpler and faster 
than motion with playfleld objects. 

Horizontal motion Is even easier than vertical mot JJJfJJj^^ * alue 

Horizontal and vertical motion are Independent; you can combine them In 
any fashion you choose. 

The scale for the horizontal position register Is one color clock per 

player one color clock to the right. ™^e are on ly because of 

iel^^ 

SSI are off the left or right edge of tje screen epe nd Ing on t he 
overscan of the television positions 0 throug 44 wi bo oft 
of the screen and positions 2x0 .hrougn wim DQS itions 44 through 

Thus, the visible region of the player Is I 
220. Remember, however, that rnis may vary from j some times be 

oonservative range s rrcm 60 to 20 0 Th J^ 1 ",, I# fl way to rem ove a 
clumsy to use, but It dees otter a nice nort2on tal position to zero, 

player from the screen Is to set the P ^er s nor.zo w BAS1C) +he 
With a single load and store in assembly (or a single we 
player will disappear. 

The svstem described so far makes It possible to produce high -speed 
-i-JJon There are a number of embellishments which greatly add to Its 
Sar^ ? , s? ^ell lsnment is that there jn ^^ Independent 

*w t^+t P*rh o I aver has Its own color register, ri »'« w,w ' * 
movable objects • tacn piayer n« . „, „ rM t s + e rs. This gives you 

£ SS? iiHo.or ^looloreo player, « not poss e «£' 

i I <?+ Interrupts (see Chapter 5/. nacn pt<3y«. no* « tj+k tk:c t« 

u st in.erruyi^ r j Allh i a width or cuadrup e width. Tn 1 s is 

ran set it to have normal width, douoie wiqth, or suqu. k _ n+{ftn 
S u" " for „akln g p.ayers t*. on deferent .Ujj. tcu a so ,v. t . opt on 
of choosing the vertical resolution of the P'^'^™ J£ horizontal 

table is 256 bytes leng; with double- line each table is i« eyres y 
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is the only case where player properties are not Independent; the selection 
of vertical resolution applies to all players. Player vertical resolution Is 
controlled by bit D4 of the DMACTL register. 

The next embellishment Is the provision of missiles. These are two-bit 
wide graphics objects associated' with the players. There is one missile 
assigned to each player; It takes Its color from the player's color 
register. Missile shape data comes from the missile bit-map table In RAM 
just In front of the player tables. All four missiles are packed Into the 
same table (four missiles times two bits per missile gives eight bits). 
Missiles can move independently of players; they have their own horizontal 
position registers. Missiles are useful as bullets or for skinny vertical 
lines on the screen. If desired, the missiles can be grouped together Into a 
fifth player, In which case they take the color of playfield color register 
3. This Is done by setting bit D4 of the priority control register (PRIOR). 
You move a missile vertically the same way that you move a player: by moving 
the missile image data through the missile RAM area. This can be difficult 
to do because missiles are grouped Into the same RAM table. To access a 
single missile you must mask out the bits for the other missiles. 

An Important • feature of player-missile graphics Is that players and 
missiles are completely independent of the playfield. You can mix them with 
any graphics mode, text or map. This raises a problem: what happens if a 
player ends up on top of some playfield image? Which image has priority? You 
have the option to define the priorities used In displaying players. If you 
wish, all players can have priority over all playfield color registers. Or 
you can set all pi ayff eld color registers (except background) to have 
priority over all players. Or you can set player 0 and player 1 (henceforth 
referred to as PO and PI) to have priority over all playfield color 
registers, with P2 and P3 having less priority than the playfield. Or you 
can set playfield color registers 0 and 1 (PFO and PF1) to have priority 
over all players, which then have priority over PF2 and PF3. These 
priorities are selected with the priority control register (PRIOR) which Is 
shadowed at GPRIOR. 

The final embellishment Is the provision for hardware collision 
detection. This Is primarily of value for games. You can check If any 
graphics object (player or missile) has collided with anything else. There 
are 54 possible collisions, and each one has a bit assigned to It that can 
be checked. If the bit Is set, a collision has occurred. These bits are 
mapped into 15 registers in CTIA (only the lower 4 bits are used). These are 
read-only registers; they cannot be cleared by writing zeros to them. The 
registers can be cleared for further collision detection by writing any 
value to register HITCLR. All collision registers are cleared by this 
command. 

In hardware terms, collisions occur when a player Image coincides with 
another Image; thus, the collision bit will not be set until the part of the 
screen showing the collision Is drawn. This means that collision detection 
might not occur until as much as 15 milliseconds have elapsed since the 
player was moved. One solution is to execute player motion and collision 
during the vertical blank interrupt routine (see Appendix i). Another 
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, , t at ,.„t 16 mUll seconds after moving e player before 

checking to p| ayei — ml ssl le graph.cs. 

There are a number of »+»^"*t,5M. area and tell the computer 

3= »jSft.^« , SJ1^rM the display area.^ 
the top of RAM .The layout of the player-mlssl le area 
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The pouter to the «l-^^FSSi^ 
PMBASE. Because of Internal I mltstl on* boundary for double 

»sty,^ 

^'s^t^Tw.rJss.^ ktses -to 

, fflU -Ue RAM by storing *.eros 

The next step Is to ««5 *»• °. UyerS " ,d 

iE.Tii ir-rfng'-mire WIW--. '~«~ " ™ 

Next, set the player parameters by serr. g 
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position, and width registers to their Initial values. If necessary, set the 
player/playf leld priorities. Inform ANTIC of the vertical resolution you 
desire by setting bit D4 of register DMACTL (shadowed at SDMCTL) for 
sfngle-IIne resolution, and clearing the bit for double-line resolution. 
Finally, enable the players by setting the PM DMA enable bit In DMACTL. Be 
careful not to disturb the other bits In DMACTL . A sample BASIC program for 
setting up a player and moving it with the Joystick Is given below: 



10 SETC0L0R 2,0,0:REM set background color to black 

20 X-1Q0:REM set player horizontal position 

30 Y=48:REM set player vertical position 

40 A=PEEK(106)-8:REM get RAM 2K below top of RAM 

50 POKE 5427 9, A: REM tell ANTIC where PM RAM Is 

60 PM8AS£»256*A:REM keep track of PM RAM address 

70 POKE 559,46: REM enable PM DMA with 2-iine res 

80 POKE 53277, 3: REM enable PM display 

90 POKE 53248, 100: REM declare horizontal position 

100 FOR l=PMBASE+512 TO PMBASE+640 :REM this loop clears player 
110 POKE I ,0 
120 NEXT I 

130 FOR l=PMBASS+512+Y TO PMEASE+51 8+Y 

140 READ A: REM this loop draws the player 

150 POKE I, A 
160 NEXT I 

170 DATA 8,17,35,255,32,16,8 

180 POKE 704, 88: REM make the player pink 

190 A=STICK(0):REM read joystick 

200 IF A=15 THEN GOTO 190:REM if Inactive, try again 

210 IF A=11 THEN X=X-1 :P0KE 53248 ,X 

220 IF A=7 THEN X=X+1:P0KE 53248 ,X 

230 IF A<>13 THEN GOTO 280 

240 FOR I =8 TO 0 STEP -1 

250 POKE PMBASE+512+Y+I ,PEEK(PMBASE+511+Y+I ) 
260 NEXT I 
270 Y*Y+1 

280 IF A<> 14 THEN GOTO 190 
290 FOR 1=0 TO 8 

300 POKE PMBASE+511+Y+I,PEEK(PMBASE+512+Y+I)) 
310 NEXT I 
320 Y=Y-1 
330 GOTO 190 



Once players are displayed, they can be difficult to remove from the 
screen. This Is because the procedure by which they are displayed Involves 
several steps. First, ANTIC retrieves player-missile data from RAM (If such 
retrieval Is enaoled In DMACTL). Then ANTIC ships the p I ayei ml ss 1 1 e data to 
CT1A (If such action is enabled In GRACTL) . CTIA has no control bits for 
player-mi ss t le graphics; It simoiy displays whatever Is in Its piayer and 
missile Graphics registers (GRAFF0 through GRAFP3 and GRAFM) . Many 
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programmers attempt to turn off playei — missile graphics by clearing the 
control bits In DMACTL and GRACTL. This only prevents ANTIC from sending new 
player-mlssl le data to CTIA; the old data In the GRAF(X) registers will 
still be displayed. To completely clear the players the GRAF(X) registers 
must be cleared after the control bits In DMACTL and GRACTL have been 
cleared. A simpler solution Is' to leave the player up but set Its horizontal 
position to zero. Of course, If this solution Is used, ANTIC will continue 
to use DMA to retrieve p I ayer-mf ss 1 1 e data, wasting roughly 10,000 machine 
cycles per second. 

Player-miss I le graphics allow a number of very special capabilities. 
They are obviously of great value In animation. They do have limitations: 
there are only four players and each Is only eight bits wide. If you need 
more bits of horizontal resolution you can always fall back on playffeld 
animation. But for hfgh speed animation or quick and dirty animation 
p I ayei — ml ss I I e graphics work very well. 

Playei — missile graphics offer many capabilities In addition to 
animation. Players are an excellent way to Increase the amount of color In a 
display. The four additional color registers they provide allow four mere 
colors on each line of the display. Of course, the eight-bit resolution does 
limit the application of players to the task of presenting multicolored 
Images. There is a way around this that can sometimes be used. Take a player 
at quadruple width and put it onto the screen. Then set the priorities so 
that the player has lower priority than a playfield color. Next reverse that 
playfleld color with background, so that the apparent background color of 
the screen Is really a playfield color. The player disappears behind this 
new false background. Now cut a hole In the false background by drawing true 
background on It. The player will show up In front of the true background 
color, but only In the area where true background has been drawn. In this 
way the player can have more than eight bits of horizontal resolution. A 
sample program for doing this Is: 



10 GRAPHICS 7 
20 SETC0L0R 4,3,4 
30 SETC0L0R 2,0,0 
40 COLOR 3 

50 FOR Y=0 TO 79: REM 
60 PLOT 0,Y 
70 DRAWTO 159,Y 
30 NEXT Y 

90 A=PEEK(106)-20:R£M 

100 POKE 54279, A 

110 PMBASE=25c*A 

120 POKE 559,46 

130 POKE 53277,3 

140 POKE 53248,100 

150 FOR I=PMBASE+512 TO PMBASE+640 

160 POKE I, 255: REM 

170 NEXT I 

1S0 POKE 704,88 



this loop fills the screen 



must back up further for GR. 7 



make player solid color 
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190 POKE 53256, 3: REM set player to quadruple width 

200 POKE 623,4:REM set priority 

210 COLOR 4 

220 FOR Y=30 TO 40 

230 PLOT Y+22,Y 

240 DRAWT0 Yt43,Y 

250 NEXT Y 



This program produces the following display: 




Figure 4.3 
masking a player for more resolution- 

Another application of player-missile graphics Is for special 
characters. There are many special types of characters that cross vertical 
boundaries In normal character sets. One way to deal with these is to create 
special character sets that address this problem. Another way Is to use a 
player. Subscripts, integral signs, and other special symbols can be done 
this way. A sample program for doing this is: 
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10 A=PEEK ( 1 06 ) - 1 6 : REM , must back up for 1-1 I ne resolution 

20 POKE 54279, A 

30 PMBASE=256*A 

40 POKE 559,62 

50 POKE 53277,3 

60 POKE 53248,102 

70 FOR I =PMBASE+1 024 TO PMBASE+1280 

80 POKE I ,0 

90 NEXT I 

100 POKE 704,140 

110 FOR 1*0 TO 15 

120 READ X 

130 POKE PMBASE+1 100+1 ,X 
140 NEXT I 

150 DATA 14,29,24,24,24,24,24,24 

160 DATA 24,24,24,24,24,24,134,112 

170 ?"t":REM clear screen 

180 POSITION 15,6 

190 ?"xdx" 



This program produces the following display: 



I xdx 



Figure 4.4 
using a player as a special character 

A particularly useful application of players Is for cursors. With their 
ability to smoothly move anywhere over the screen without disturbing its 
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contents they are ideally suited for such applications. The cursor can 
change color as it moves over the screen to indicate what It has under it 

Player-missile graphics provide many capabilities. Their uses for 
action games as animated objects are obvious. They have many serious uses 
well. They can add color and resolution to any display. They can present 
special characters. They can be used as cursors. Use them. 



MOVING A PLAYER 

JB 10/81 

0 GOSUB lQOOtREM initialize player 

1 u=iq:d=5o:e=9o:w=iio 

2 SE=150 :ne=zoo :SW=250 :NW=300 

5 ON STICK(O) GOTO 5 , 5 , 5 , 5 , SE > NE > E , 5 , SW , NW , W , 5 , D , U , 5 
10 X=X-i:iF X<0 THEN X=0:REM «ove up 
20 POKE PlADR+X+8,0 
30 POKE P1ADR+X,231 
40 GOTO 5 

50 X = X + i:iF X>250 THEN X=25 0 i REM wove down 
60 POKE P1ADR+X-8,Q 
70 POKE P1ADR+X.231 
80 GOTO 5 

90 H=H+i:iF H>200 THEN H-200JREM Move east 
10 0 POKE HI, Hi GOTO 5 

110 H=H-i:iF H<50 THEN H=50 ♦ REM Move west 
120 POKE H1,H:G0T0 5 

150 X=X+ltIF X>250 THEN X=250JREM Move diagonally- southeast 

160 POKE PlADR+X-8,0 

170 POKE P1ADR+X,231 

180 H=H+i:iF H>20 0 THEN H=20 0 

19 0 POKE Hl,H:GOTO 5 

200 X = X-i:iF X<0 THEN X = 0 J REM Move northeast 
210 POKE P1ADR+X+8, 0 

22 0 POKE P1ADR+X,231 

23 0 H*H+l'tXF H>20 0 THEN H=2 0 0 

24 0 POKE HI ,H J GOTO 5 

250 X-X+ltIF X>250 THEN X=250tREM Move southwest 

260 POKE PlADR+X-8,0 

270 POKE P1ADR+X,231 

280 H-H-UIF H<50 THEN H=50 

29 0 POKE HI #H: GOTO 5 

30 0 X-X-1 MF X<0 THEN X = Q ♦ REM Move northwest 
310 POKE PlADR+X+8,0 

32C POKE P1ADR+X,231 

330 M*H-1*ZF H<50 THEN H=50 

340 POKE Hit H: GOTO 5 

90 G REM *>0<XX*XXXXXXXXXXXXXXXXXX*^^ 

910 REM initialization of player 

920 REM 5K)K«»?KX<)K?{<X<XX)K»««*)KX»C)«»:*X^ 

930 REM 559 controls resolution: a 62 selects single-line resolution* 

940 REM 106 is RAMTOP* We're stepping back 24 pages for PMBASE (54279) 

950 REM A 3 in 53277 enables the players* 

960 REM Player #1 starts at an offset of 1024 froM PMBASE ♦ 

970 REM We set the color and horizontal position 

980 REM then initialize the player by poking in zeroes* 
99 0 REM ****** x**xxxxx***x:***tt^ 

10 0 0 GRAPHICS 7:SETC0L0R 2,0,0 

1010 POKE 559,62tI=:pEEK< 106)-24tPOKE 54279 , I : POKE 53277 , 3 t P 1 ADR=I*256+ 1 0 

1 020 POKE 704,66* HI -53248 t H~5 0 J POKE H1,H 

1 030 FOR* J>0 TO 255tP0KE PI ADR+I , 0 t NEXT I 

10 40 RETURN 



P 1 ayer /M i ss i 1 e Gr aph i cs 
COLLISION DETECTION 



W h e n y o u a r e u s i n 9 P 1 a y e r / M i s s :i. 1 e G r a p h i cs» it i s p o s s i b 1 e t o 
d e t e c t c o 1 1 i s i o n s b e t w e e n p 1 a y e r s a n d m i s s i 1 e s ? p 1 a y e r s a n d o 1 h e r 
P> 1 a y e r s * a r b e t w e e n t h e p 1 a y f i e 1 d a n d e i t h e r p layers o r m i s & i 1 e $ ♦ I n 

0 r d e r t o d o t ft i s » y o u m u s t c h e c k t h e v a I u e s a t t h e s p e e :i. a 1 col 1 i s i o n 
r e g :L s t ers* T h e n i j m b e r s r e f 1 e c t t h e b :i. t p a 1 1 e r n s w h i c h t ell yo u 
exactly which player * Missile or playfield object has been hit* 

There are 16 collision registers* and a special register called 
H I T C L R * w h i c ft c 1 e a r s a 1 1 o f t h e o t h e r r e g i s t e r s ♦ H I T C L R i s 
write-only* w h i c h Me a n s yo u c a n o n 1 y P 0 K E i t J i f y o u c h e c k t h e P E E K ♦ 
it will not Match what you put there* POKEiriQ anything other than a 0 
into MIT OUR (decimal location 53278) will have the effect of clearing 
all co 1 1 i s i on register s * 

The collision registers themselves are read-only* You cannot 
POKE into theft « They can be cleared by writing to HITCLR* but that is 
the only way to change theM* The contents of these registers reflect 
the state of the screen display* When any object occupies the saMe 
c o o r d i n a t e s a s a n y o t h e r o b j e c t f t h e a p p r op r i a t e b i t i s t u r n e d o n * 

The player to player collision registers are located at dec i Mai 
1 o e a t i o n s 5 3 2 6 0 t o 5 3 2 6 3 ♦ T h e f i r s t i s f or player 0 * t h e n e x t f o r 
p 1 a y e r 1 1 a n d s o o n * T h e 1 e a s t s i g n i f i c a n t n y b b 1 e is u s e d t o s h o w 
c a 1 1 i s i o n s ♦ b i t D 0 s h o w s a c o 1 1 i ^> o n wit h P 1 a y e r 0 * b i t D 1 s h o w s a 
c o 1 1 i s i o n w i t h p 1 a y e r 1 f b i t s D 2 a n d D 3 w i t h p 1 s y e r s 2 a n d 3 ♦ T h u s f 

1 f y o u f i n d t h b t P E E K ( 5 3 2 6 1 ) : ~ ^ * i t m e a n s t h a t play e r 1 h a s r u n i n t o 

P 1 ay er 2 ♦ the D2 b i t of the p 1 ay er 1 co 1 1 i s i on r eg i s t er i s t ur ned on * 
or set ♦ The 1 oca t i on 53261 conta i ns the b i nar y nuMber 0 0 0 0 0 1 0 0 * If 
player 1 has also run into player 0 since the last tine the registers 
wer e c 1 ear ed * the 1 oca t i on con t a i ns a 5» b i nary 0 0 0 0 0 1 01 * The b i t 
for an ob J ec t ' s co 1 1 i s i on w i th i t se 1 f i s a 1 ways 0 * 

The previous four locations* 53256 to 53259* show collisions 
between Missiles and players* The bit patterns are the saMe* bit DO 
still shows a col 1 is on between player 0 and whichever Missile you are 
c h e c k i n g o n * T h e p r e v i o u s f o u r 1 o c a t i o n s ♦ 5 3 2 5 2 t o 5 3 2 5 5 * % h o w 
c o 1 1 i s i o n s b e t w e e n t h e p layers a n d t h e p !L a f i e 1 d * 53 2 3 8 ~ 5 3 2 5 1 s h o w 
co 1 1 i s i ons be tween m i ss i 1 es and p 1 ay f ield ob J ec t s ♦ 

T h e p 1 a y f i e 1 d i s a ri y t hi n g w h i c h i s d r a w h o n t h e scree n u s i n g 
regular display- list graphics* as opposed to p layer /Miss i le graphics* 
Playfield objects are drawn in BASIC with the PLOT and DRAWTQ 
c o m m a n d s ♦ T h e r e a r e f o u 7^ t y p e s o f o b J e c t s * e a c h d r a w n w i t h o n e o f t h e 
c o 1 o r r e g i s t e r s * L o g i c a 1 1 y e n o u g ft * o b J e c t s d r a w n w i t ft color r e g i s t e r 
0 are playfield type 0* those drawn with register 1 are type 1, and 
s o o n * The c o 1 1 i s i o n b i t s * t ft e n * a r e t h e s a m e a s f o r p 1 a y e r s ♦ b i t C) 0 
s ft o w s a e o 1 1 i. s i o n w i t h p 1 a y f i eld o b j e c t t y p e 0 * Y o u will s e e t hat all 
playfield objects of the saMe type always show the saMe color* 
a 1 1 ft o u g h t ft a t e o 1 o r c^ a n b e a ri y o r*i e o f t ft e 1 2 8 * a r*i d all o f t ft e 
r e g i s t e r s c o u 1 d e v e n c o n t a i n t h e s a m e c o lor* s o t h a t n o t h i n g w o u 1 d 
s h o w o n t ft e <^> c r e e n ♦ b u t c o 1 1 i s i o n s w o u 1 d s t ill r e g i s t e r ♦ R e m e m b e r 
t ft a t i n g r a f> ft i s m o d e s 0 a n d 3 * t ft e b a c k g r o u n d u s e s c o I or re g i a t e 0 * 
s o t h e re will a 1 w a y s b e a c o 1 1 i s i o n t % e g i s t e r e d b e twee ri f> !L a f i e 1 d 
o b J e t 0 a n d a 11 pi a e r s a n d m i ii> ?i i 1 e s t ft a t a t % e o n t h e s c r e e n * 



f- l a v t~ r y h x e e x l. e o r a r h x c s 
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The priority of players and plsyfield objects can be 
c o n t r o 1 1 e d b y s e 1 1 i n g b i t s i n t h e p r i o r i t y r e g i s t e r ? F :< F* 1 0 R ? 
location $D016« PRIOR has a RAM shadow, GPRIOR, at *26F, 
or decimal 623* By poking different bits on at this 
1 o c a t i o n ? y o u c a n e o n t r o 1 w h e t h e r t h e p 1 a y e r p a s s e s i n 
f r o n t o f o r b e h i n d a p 1 a y f i e 1 d o b J e c t o f a p a r t i e u 1 a r 
color * 

There are four types of priority, each of which is 
s e 1 e c t e d w i t h o n e o f t h e f o u r 1 e a s t - s i g n i f i 9 a n t b i t s o f 
F : ' R 1 0 R * & i t DO s e 1 e c t s a m o d e i n w h i c h a 1 1 p 1 a y e r s p a s s i n 
f r o n t o f a 11 p 1 a y f i e 1 d o b J e c t s * B i t D 1 s e 1 e c t s t hi e m o d e i n 
which players 0 and 1 go in front? and players 2 and 3 go 
b e h i n d t h e p 1 a y f i e 1 d o b j e c t s * W h e n b i t D 2 i s s e 1 ? a 1 1 
P 1 a y f i e 1 d o b J e e t s h a v e p r i o r i t y over a 1 1 p 1 a y e r s ? a n d w hi e n 
bit D3 is set* playfield objects 0 and 1 have priority over 
players? which have priority over objects 2 and 3* In all 
c a s e s : > a 1 1 p 1 a y e r s a n d a 1 1 o t h e r p 1 a y f i e 1 d t y p e s h a v e 
P r i o r i t y o v e r 1 h e b a c k g r o u n d a n d a ri y t h i n g d r a w n i n t h e 
b a e k g r o u n d c o 1 o r ♦ There i s a e h a r t o f t h e s e p r i o r ities? 
a 1 o n g w i t h s o m e d e t a i 1 a o n o n f 1 i c t i fi g p r i o i t i e s f i n T e c h 
U s e r N o tes» C 0 1 6 5 5 5 f o n p a g e 1 1 1 * 3 o f t h e H a r d w a r e M a n u a 1 * 

T h e f o 1 1 o w i n g p r o g r a M s h o w s p i o i t i e s i n a c t i o n * A 
P 1 a y f i e 1 d i a d t % a w n ? u s i n g a 1 1 t h r e e c o 1 o r s f e a c h c o 1 o r 
b e i n g a p 1 a y f i e 1 d o b J e c t t y p e ♦ Y o u s e 1 e c t w h i c h p 1 a y e r y o u 
want to use? 1-4* The prog ran then asks you to select a 
P r i o i t y * T hi e c h o i c e s ? 1,2 ,4 o r 3 ? a r e t h e n u fibers t ha t c a n 
be poked into GPRIQR to turn on the appropriate bit* Once 
y o u h a v e s e 1 e c t e d t hi e p r i o r :i. t y ? . m o v e t hi e p 1 a y e r a e r o s s t h e 
different playfield objects? using the Joystick* Hove the 
J o y s t i e \<. d o w n t o m a k e t h e p 1 c< y e r a p p e a r t K e f i r s t t i m e ♦ 
H h e ri y o u p r e s s t hi e t r i g g e r ? y o u c a n s e 1 e e t a r'i e w p r i o r i t y * 
T o s e 1 e c t a d i f f e e n t p 1 a y e r ? h ;i. t R E 3 E T a n d R U N t h e f> r o g r a m 
again * 



F" r x o R in: t y 
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0 GOSUB 10 00 : REM initialize player 

1 GOSUB 2000ZREM set up plsyf ield 

2 U = l 0 t D~50 : E~90 : W = l 1 0 : REM Motion routine locations 

3 SE=150 :NE=200 :SW=250 :nw=300 

4 ? "PRIORITY 1 ,2,4, 3" H INPUT PJPOKE 623 , P ** REM set priority 

5 ON STICK(O) GOSUB 5 , 5 , 5 , 5 , SE , NE , E , 5 , SW , NW , W * 5 , D , U , 6 

6 IF STRIG<0>®0 THEN GOTO 4 

7 GOTO 5* REM Move player with stick 

3 REM XKPlease Note t If the stick doesn't Move, you juMP out of the gosub* 

? REM Eventually the stack will overflow, & you'll get error 2 at line 5* 

10 X = X-i:iF X<0 THEN X = 0 1 REM Move up 

2 0 POKE PlADR+X,23i:PQKE PI ADR+X+8 , 0 i RETURN 

50 X=X+1JIF X>250 THEN X=250:REM Move down 

60 POKE P1ADR+X, 231 S POKE PI ADR+X-8 , 0 t RETURN 

9 0 W=H+1 J IF H>20 0 THEN H=20G:REM Move east " 
100 POKE H1,H: RETURN 

110 H*H-ltIF H<5 0 THEN H*S0 IREH Move west 
120 POKE HI, H: RETURN 

150 GOSUB D: GOSUB E: RETURN tREM southeast 
20 0 GOSUB U t GOSUB E ♦ RETURN ♦ REM northeast 
25 0 GOSUB D: GOSUB W * RETURN t REM southwest 
30 0 GOSUB UJ GOSUB W t RETURN tREM northwest 

1 0 0 0 GRAPHICS 5:? "PLAYER 1,2,3 OR 4 n } ♦ INPUT PLNUM t REM select player 
1010 IF PLNUM=1 THEN QFFSET*1024i CQL : ."7Q4 1 Hl*53248 
1012 IF PLNUM*2 THEN OFFSET^ 123 0 5 COL==7 0 5 I HI =53249 
1014 IF PLNUM=3 THEN 0FFSET=1536 5 COL=706 : Hl«53250 
1016 IF PLNUM»4 THEN 0FFSET=1792 X CQL-707 : Hl«53251 

1 0 20 POKE 559,62:i=PEEK< 106) -32 J POKE 54279 , 1 * POKE 53277 , 3 1 PI ADR»I*256+0FFSET 
1030 POKE CQL,66:H=50 tPOKE H1,H 

1040 FOR 1 = 0 TO ZSStP-OKE PI ADR + I , 0 5 NEXT I J REM clear player 

10 50 RETURN 

20 0 0 REM set up playfield 
2020 COLOR 1 

2030 FOR X = 10 TO 2QJF0R Y = 0 TO 39 

2040 PLOT X,Y 

2050 NEXT Y ♦ NEXT X 

2060 COLOR 2 

2070 FOR X=30 TO 40:FOR Y=0 TO 39 
2080 PLOT X,Y 

2 09 0 NEXT YtNEXT X 
210 0 COLOR 3 

2110 FOR X = 50 TO 6 0 * FOR Y = 0 TO 39 

2120 PLOT X,Y 

2.130 NEXT YtNEXT X 

214 0 RETURN 



1 REM t EZPLAYER 

2 REM t EZ/JB 11/81 

4 REM J M3ke BASIC think the player/Missile area is 3 string: 

5 REM J player wovenent is then accomplished by str inq-3ssignMerit 

9 REM **x*xxx*****x***x**x**^ 

100 DIM P*<1> *D*<22) 

108 REM player/string of control characters 

109 REM contains spaces on ends to erase previous image 

110 0%» n W«< 4 HK«W 

119 REM assign locatiqn of vsrisble value table, and string-array area 

120 VTAB=PEEK< 134)+256*PEEK< 135) 
130 ATAB=PEEK< 140 >+256xPEEK< 141 ) 
200 GRAPHICS 8 

210 POKE 559, 62: REM set resolution 
230 POKE 704,88:REM set color 

240 PM6ASE*PEEK ( 1 0 6 ) -8 ♦ REM step back frow RAMTOP 

250 POKE 54279, PMBASEtREM to set PMBASE 

260 POKE 53277 , 3 X REM enable players 

270 POKE 53256, 3:REM at quadruple size 

340 X*l 10 SPOKE 53248, XtREM set horizontal position 

50G OFFSET=256*PMBASE+1024-ATAB:REM figure offset to player 0 

510 V3»XNT < OFFSET/256 > t REM hi-byte 

520 V2=QFFSET~25£*V3:REM lo-byte 

530 POKE UTAB+2, V2JREM displacement of player (string) from STARP 
54 0 POKE VTAB+3, M3JREM hi-byte 

550 POKE VTAB+4,20 tREM string length (266 bytes) 
560 POKE UTAB>5,i:REM hi-byte 

570 POKE yTAB + 6,20 J REM dimension length (266 bytes) 
580 POKE VTAB+7, 1 SREM hi-byte 

590 Y--110 tP$<Y,Y+21 )=D$:REM initialize string-player in middle of screen 

600 FOR EVER*0 TO 0 STEP 0:REM check stick 

610 IF STRIGCO)«0 THEN BOO t REM use trigger to exit 

620 3VAL=STICK< 0 ) MF SVAL»15 THEN 690 

641 IF SVAL>4 AND SUAL<3 THEN X*X+1 

642 IF SVAL>8 AND SVAL<12 THEN X = X-1 

644 IF 3VAL*5 OR SUAL»9 OR SMAL»13 THEN Y*Y+2 
647 IF SVAL«6 OR 3UAL-10 OR SVAL=14 THEN Y-Y-2 

670 POKE 53243, X:P*(Y, Y+21 )=D*tREM set horizontal and vertical position 

69 0 NEXT EVER 

BOO POKE 53248*1* REM horizontal position off screen for exit 
810 POKE 53277, Q J REM disable Player /Missi le DMA 
899 REM KXXXX**XX*xxxx*x;K)r*^ 

90 0 REM the following subroutine can be used to define 

910 REM the string of control characters which contains the player shape* 
1 0 0 0 DO»'W 

10 05 ? "3 0 0 TO STOP" 

1010 ? "BIT PATTERN »" J JINPUT N 

1020 IF N*30 0 THEN 10 50 

1 0 3 0 D O < LEN ( D $>•*-!) *CHRO ( N ) 

1040 GOTO 1010 

1. 50 !>0<LEN<D'0>+1 )*'W" 

1 . 6 0 R E T J R M 



& DISPLAY LIST INTERRUPT 



1 REM ** Use 3 Display List Interrupt to change the color of the first line 

2 REM ** of a graphics 2 screen* 

3 REM ****x*x**)K JB 10/81 khcx******** 
10 GRAPHICS 2 

15 REM xx This is the Machine language service routine 

20 DATA 72,138,72,141,10,212,169 

21 DATA 195 

22 REM the 195 is the color, in this case green* 

23 DATA 141,26,208,162,15,141,10,212,202,208,250,173,200 

24 DATA 2,141,26,208,104,170,104,64 
30 FOR 1=1536 TO 1536+28 

40 READ At POKE X,A«R£M Set up Machine language service routine on page 6* 
50 NEXT I 

60 POKE 512,0:POKE 513,6;REM Point DLI Vector to page 6 routine* 
7 0 DL=PEEK ( 560 ) +PEEK (561) *256 

80 POKE DL+2, 1 12+128 : REM Put interrupt in first Mode line of display list 
90 POKE 54286, 192:REM Enable display list interrupts 
100 PRINT #6; M THIS IS COLOR 195 M 
110 GOTO 110 



The following is a listing of the asseMbly language routine which 
changes the color, keeps it for one Mode line, and changes it back* 



D40A 




10 WSYNC 




$D40A 


D01A 




20 COLBAK 




$D01A 


02C8 




30 SHADOW 




*2C8 


0 0C3 




40 COLOR 




195 


0000 




50 


*= 


$600 


0600 


48 


60 


PHA 




0601 


8A 


65 


TXA 




0602 


48 


67 


PHA 




0603 


8D0AD4 


70 


STA 


WSYNC 


0606 


A9C3 


80 


LDA 


♦COLOR 


0608 


8D1AD0 


90 


STA 


COLBAK 


060E: 


A20F 


0100 


LDX 


**F 


060D 


8D0AD4 


0110 LOOP 


STA 


WSYNC 


0610 


CA 


0120 


DEX 




0611 


D0FA 


0130 


BNE 


LOOP 


0613 


ADC802 


0140 


LDA 


SHADOW 


0616 


8D1AD0 


0150 


STA 


COLBAK 


0619 


68 


0160 


PLA 




061A 


AA 


0170 


TAX 




061B 


68 


0180 


PLA 




061C 


40 


0190 


RTI 





RAM SHADOWS 



J 6 10/8 1 



A number of OS and Player /Missile locations have RAM 
shadows* Shadow registers are used to update the actual 
h a r d w a r e r e g i s t e r s d u r i n g t h e v e r t i c a 1 b 1 a n k r o u t i n e ♦ EE a c h 
s i x t i e t h o f a s e c o n d * a f t e r t h e s c r e e n i s u p d a t e d * t h e 
U B L A N K r o u t i n e p e r f o pms a n u m h e r o f h o u s e k e e p i n 9. f u n c t i o n s * 

0 n e o f t h e t h i h 9 s t h a t h a p p e n s • d u r i n 9 g E-: L A N K i s t h a t t h e 
operating system reads the value from each shadow register 

1 n R A M a n d w r i t e s t h e v a 1 u e i n t o t h e c o r r e s p o n d i n 9 h a r d w a r e 
register * 

The shadow registers can be used along with display 
1 i s t i n t e r r u p t s to p r o d u c e d i f f e r e n t e f f e c t s ♦ T h e color 
registers* for example $ are all shadowed * so a display list 
i n t e r r u p t t h a t c h a n g e s a e o 1 or c a n u p d a t e e i t h e r t ft e 
hardware register or its shadow ♦ If the hardware register 
i s c ft a n g e d d i r e c t ly? t h e n e w c o 1 or w i 1 1 a p p e a r o n t ft e 
screen immediately* wherever the interrupt occurred* When 
t ft e e 1 e c t r o n s c a n r e a c h e s t h e b o 1 1 o m o f t h e scree n > t h e 
M El: L A N K r o u t i n e w i 1 1 r e a d t ft e o r i g i n a 1 v a 1 u e f r o m t h e s h a d o w 
register* and restore it to the hardware register* The 
o r i g i n a 1 c o 1 o r w i 1 1 t h e n a p p e a r a t t ft e t o p o f 1 1 "1 e s c r e e n * 
a n d r e m a i n t h e r e u n t i 1 i t e n c o u n t e r s t h e i n t e r r u p t a g a i n ♦ 

I f * i n s t e a d o f c h a n g i n g t h e r e g i s t e r i n y o u r i n t e r r u p t 
routine* you change the value in the RAM shadow* the change 
will not be apparent until the V BLANK* No change will occur 
a t t ft e i n t e r r u p t * b u t w h e n a n e w s c r e e n is w r i 1 1 e n * i t w i 1 1 
c o n t a i n t h e n e w c o 1 o r ♦ T h e c h a n g e will t h e n b e p e r m a n e n t ♦ 
a f f e c t i n g t h e w h o 1 e s c r e e n ♦ a n d 1 a s t i n g b e y o n d t ft e f r a m e i n 
w h i c ft t h e i n t e r r u p t o c e u r r e d * 

S o i v i e o f t ft e f a h i 1 i a r 1 o c a t i o n s s u c h a s C H ( 1 a s t k e y 
p r esse d >v 76^)* C F-l B A S E ( e h a r a t e r s e t p o i n t e r .* 7 5 6 > a n d e v e n 
t ft e d i s p 1 a y 1 i s t p o i n t e r ( S 6 0 * 5 6 :L ) are a c t u ally t h e R A M 
s h a d o w s o f 1 1"« e ft a r d w a r e r e g i s t e r s * T ft e c o n t r o 1 1 e r 1 o e a t i o n s 
( p a d d 1 e a n d J o y s t i o k ) are a 1 s o s ft a d o wed* 
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Switching Between Screens 

SoMetiMes you May wish to store the data for two or More 
separate screens* This is soMetiMes known as paging* You can 
then switch quickly between images, without having to draw each 
one over again each tiMe* It is easy to switch* since the area 
of RAM which holds the screen display data is not fixed* but is 
deterMined by pointers* 

There are two pointers into screen RAM* One is an OS 
pointer called SAVMSC* at $58 (lo byte) and $59 (hi byte)* The 
decimal locations are 88 and 89* so the decimal location of the 
start of the screen data is PEEK < 38 ) +PEEK < 89 ) *256 ♦ The other pointer 
is the LMS address at the 5th and 6th bytes of the display list* 
The display list itself is located by a pointer at decimal 560 
and 561* so to find the LMS address* set 

[)L^PEEK(56G)+PEEK<561>*256* then LMS lo-byte is at DL+4, hi-byte 
at DL+5* 

In order to change the address of screen RAM* change both 
of these locations* In order to display one screen while 
updating the other* point the LMS to the screen you wish to see* 
and 3AUMSC to the screen you wish to update* 

E'.e sure that you have allotted enough RAM space for the 
graphics Mode you are using* ReMeMber ♦ each Mode uses a 
different nuMber of bytes for the screen* If you are Mixing 
Modes* you Must add up the bytes yourself* 



U s i n 9 C e n t r a I I / 0 

JB 10/81 

The following prograM is an example of a sinple use of 
t h e C e n t r a 1 I / 0 r o u t i n e w h :i. c h i s b u i 1 1 i n t o t h e 0 p e r a t i n 9 
S a s t e m * T h i s e x a m p 1 e a c c e p t s i n p g t f r o m t h e k e y b o a r d 
( d e v i c e K * ) a n d o u t p u t s t h e d a t a t o t h e s e r e e n ( d e v i c e 8 J ) * 
This is similar to ME MOP AD* the default Mode of the GS when 
n d c a r t r i d 9 e o r p r o 9 r a n i s p r e s e n t ♦ 

I n o r d e r t o u s e C I G ( C e n t r a 1 I/O ) ♦ i t i s n e c e s s a r y to 
set up an IOCB < I/O Control Block) with the appropriate 
P a r a m e t e r s ♦ Some com m a n d s w h i c h c a n b e s e n t t h r o g 9 h t h e 
IOCB are the sane for all devices * OPEN * CLOSE* GET* and 
P U T f f a r e x a m p 1 e ♦ T h e r e are 8 I G C B s * e a c h o n e • 1 6 by t e s 
Ion 9* Each of the 16 bytes has a special Me an in 9* The 
coMMand* for example, goes in the third byte* called ICCQM* 
T ft e d e t a i 1 s o n t h e parsMe t e r s f o r e a c h c o m m a n d a n d f or each 
d e v i c e * are 9 i v e n i n t ft e G 8 m a n u a 1 * u n d e r t h e h e a d i n 9 
1 1 d e v i c e s p e c i f i c i n f o r m a t i o n 1 * ♦ 

T h i s e x a m p 1 e p r o 9 r a m o p e h s two I G C B s * # 1 for t h e 
keyboard and #2 for the screen* IOCB #0 is not used? since 
i t i s g s e d b y t h e s y s t e m f o r t h e s c r e e n e d i t o r ♦ I G C B # 0 
s t a r t s a t 1 o c a t i o n $ 3 0 * 8 i n c e e a c h I G C B i s s i x t e e n b y t e s 
Ions, #1 starts at $35 0, *2 at $36 0 * #3 at $37 0, and so on* 
Therefore, the bytes are defined as given in the G3 Manual 
( p * 210) f o r I G C B * 0 * a n d a n o f f s e t o f 1 6 b y t e s ( $ 10) i s 
3 d d e d f o r e a c h I G C B n u m b e r ♦ T ft e c o m m a n d s a r e d e f i n e d n e k t ♦ 
a s 9 i v e n i n t ft e G 3 m a n u a 1 o n p a 9 e 2 0 2 * 

T h e f i r s t s e c t i o n o f t h e p r o 9 r a m * 1 i n e s 2 0 0 t o 3 * 0 * 
s e t s u p t ft e paraM e t e r s t t h e G P E N c o m m a n d i s 1 o a d e d i n t o 
lOCBs #1 and #2* the Read bit is put into the AUX1 byte of 
#1, and the Write bit in the AUX1 byte of #2* The Buffer 
A d d r e s s b y t e s a r e u s e d t o p o i n t t o t h e d e v i o e s p e c i f i e r * i n 
t h i s c a s e a n A 3 C: 1 1 K t f o r t h e k e y b o a r d , a n d a n A 8 C 1 3! 3 *" f o r 
the screen* The ASCII characters are stored in data bytes 
( ♦ B Y T EE ) a t t h e e n d o f t ft e p r o 9 r a m * 

W h e ri a 1 1 o f t h i s i n f o r m a t i o n i s s t o r e d i n t o t h e 
c o r e c t b y t e s o f t ft e c o r r e c t I G C s , t h e p r o 9 r a m c a 1 1 •=> 
Central I/O, Lines 360-390 put the offset to the IOCB 
n u m b e r i n t ft e X - r e 9 i s t e r , t h e n j u m p s a v i n 9 r e t u r n a d d r e s s 
t o G I G U ( $ E /J t 5 6 ) ♦ T h i s e k e c u t e s t h e o o m m a n d 9 i v e n i n t ft e 
coMMand byte* 

T ft e n e x t s e c 1 3. o n o f c o d e * 1 i. n e s x k 1 0 - 3 ? 0 , r e s e t t ft e 
c? o m m a n d s t o G E T a c h a r a c t e r f t- o m t h e k e y b o a r d (I G C B # 1 ) a n d 
P U T a c h 3 r a c t e t o 1 1^1 e s c r e e n ( I G C B * 2 ) ♦ A b u f f e r 1 e n 9 1 ft 
of 0 is specified* This has the special effect of passing 
t h e d a t a i n t ft e a c c u m u 1 a t o r * s o n o s p e c i a 1 b u f f e r a d d ress 
i s r equ i r ed * 

T h e f i n a 1 s e c t i o n o f c o d e * 1 i n e s 5 8 0 - 7 0 0 .* p e v f o r m s t h e 
a c t u a 1 o p e r a t i o n b y c a 1 1 i i"i 9 C I G V * A n i n f i n i t e 1 o o p i s s e t 
u p * S i i"i c e t h e p a r a m e t e r s i n t h e I G C B s cj r e r*i o t c a r'i 9 e d * t h e 
s a m e c o m m a n d s a r e e x e c u ted* a r i d t h e c o m |:j u t e r c o n t i n u e s t o 
G E T f r o m t ft e k e y b o a r d a n d P U T t o t h e s c r e e n u ri t i 1 t h e B R E A K 
key or 3/RE8ET is pressed* 



0 0 0 0 



0342 
0344 
0345 
034A 
E456 
0348 
0349 



00 03 
000C 
0007 
OOOB 

0000 

0600 
0602 
0605 
0608 
060A 
060D 
060 F 
0612 
0614 
0617 
0619 
061C 
G61E 
0 621 
0623 

0626 
0 628 
0 62B 
062D 2 0 56E4 



A003 

8C5203 

8C6203 

A054 

8C5403 

A006 

BC55Q3 

A004 

8C5A03 

A056 

8C6403 

A006 

8C6503 

AO 08 

8C6A0 3 

A210 
2056E4 
A22 0 



0630 
0 632 



AO 0 0 



0 635 8C5903 

0 A 



a 

0 63E: 
0 63E 
0640 
0 643 
0645 



8C6803 
8C6903 
A 0 0 7 
8G5203 
A 0 0 B 
8C6203 



0648 A210 



0 64 A 
064D 
0 6 4 F 



2 0 56E4 

m /.. u 
2 0 56E4 



0 65 2 D0F4 



0654 
0655 
0 6 5 6 
0 6 5 7 
0658 



.<-«. £' 

%:> R 

53 
3 A 
0 0 



♦ 
t 

♦ 
♦ 

4 
t 

♦ 
t 



05 
10 
15 
20 
21 
25 
30 
40 
50 
60 
70 
80 
90 
0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0200 
0210 
0220 
0230 
0240 
0250 
0260 
0270 
0280 
0290 
0300 
0310 
0 32 0 
0330 
0-340 
0 35 0 
0 36 0 
0 37 0 
0 38 0 
0 39 0 
040 0 
0 410 



♦OPT NOEJECT 
USING CENTRAL I/O : 



MEMQPAD 
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USE CIO TO 
AND OUTPUT 



ACCEPT INPUT FROM THE KEYBOARD 
DATA TO THE SCREEN 



ICCOM 
ICBAL 
ICBAH 
ICAX1 
CIOV 
I C E> L L 
ICBLH 



8058 0 3 0 42 0 



0 43 0 
0 44 0 
0 45 0 
0 46 0 
0470 
0 4 8 0 
0 49 0 
0 5 0 0 
0510 
0 52 0 
0580 
0 5 9 0 
0 6 0 0 
0 6 1 0 
070 0 
0 7 i 0 

U / .<:. u 



♦ 

t 



OPEN 

CLOSE - 
GETCHR « 
PUTCHR a 



t 



♦ 

t 



♦ 
t 



* 
t 



* = 

LDY 
STY 
STY 
LDY 
STY 
LDY 
STY 
LDY 
STY 
LDY 
STY 
LDY 
STY 
LDY 
STY 

LDX 
JSR 
LDX 
JSR 

LDY 
STY 
STY 
STY 
STY 
LDY 
STY 
LDY 
STY 



$0342 
$0344 
$0345 
$034A 
$E456 
$0348 
$0349 



$03 
$0C 
$07 
$0B 

$0600 



t COMMAND CODE 

i buffer address lo 
j buffer address hi 
;aux byte i 

t CENTRAL I/O VECTOR 
t BUFFER LENGTH LO 
J BUFFER LENGTH HI 

t CODE FOR OPEN 

JCODE FOR CLOSE 

J CODE FOR GET CHARACTER 

t CODE FOR PUT CHARACTER 



J IN IT IOCB FOR OPEN 



?PT TO DEVICE 



♦ OPEN 
ICCOM+$10 
ICCOM+$20 
♦KC0L0N&255 
XCBAL+tlO 
♦KC0L0N/256 
ICBAH+$10 

#$4 {SET READ BIT 

ICAX1+$10 
♦SC0L0N&255 
ICBAL+$20 
#SC0LQN/256 
ICBAH+$20 
#$8 

ICAXl+$20 



{SET WRITE BIT 



#$10 
CIOV 
#$2 0 
CIOV • 

#0 

ICBLL+$1Q 

ICBLH+*10 
ICBLL+$2 0 

ICBLH+'*'20 

♦GETCHR 

ICCOM+M0 

♦PUTCHR 

ICC0M+*2Q 



{OPEN KEYBOARD 



J OPEN SCREEN 



{INITIAZIZE IOCB'S FOR GET/PUT 
{SET BUFFER LENGTH 



GET FROM KEYBOARD > PUT TO SCREEN 



LOOP 



L. U a 
JSR 
L D X 
JSR 
& N E 



#$10 
CIOV 
♦ * 2 0 
CIOV 
LG OP 



KCOLON ♦ BYTE 11 K ♦ 



073 0 SCOLON ♦ BYTE 



"SI 



1 1 



1 1 



{RESERVE ASCII K 



{RESERVE ASCII S 



11 / ».J !.! 



B R K 



CHAPTER 5 
DISPLAY LIST INTERRUPTS 



The display list Interrupt Is one of the most powerful capabilities 
built Into the ATARI Personal Computer System. It is also one of the least 
accessible features of the system, requiring a firm understanding of assembly 
language as well as all of the other characteristics of the machine. Display 
list Interrupts all by themselves provide no additional capabilities; they 
must be used In conjunction with the other features of the system such as 
player-miss! le graphics, character set Indirection, or color register 
Indirection. With display list Interrupts the full power of these features 
can be deployed. 

Display list Interrupts take advantage of the sequential nature of the 
raster scan television display. The television draws the screen Image In a 
time sequence. It draws Images from the top of the screen to the bottom. This 
drawing process takes about 13,000 microseconds, which looks Instantaneous to 
the human eye, but Is a long time In the time scale that the computer works 
In. The computer has plenty of time to change the parameters of the screen 
display while It Is being drawn. Of course, It must effect each change each 
time the screen Is drawn, which Is 60 times per second. Also (and this Is the 
tricky part), It must change the parameter In question at exactly the same 
time each time the screen Is drawn. That Is, the cycle of changing screen 
parameters must be synchronized to the screen drawing cycle. One way to do 
this might be to lock the 6502 up Into a tight timing loop whose execution 
frequency Is exactly 60 Hz. This would make It very difficult to carry out 
any computations other than the screen display computations. It would also be 
a tedious job. A much better way would be to Interrupt the 6502 Just before 
the time has come to change the screen parameters. The 6502 responds to the 
interrupt, changes the screen parameters, and returns to Its normal business. 
The Interrupt to do this must be precisely timed to occur at exactly the same 
time during the screen drawing process. This specially timed interrupt is 
provided by the ANTIC chip; It Is called a display list Interrupt. 

The timing and execution of any Interrupt process can be Intricate; 
therefore I shall first narrate the sequence of events In a properly working 
display list Interrupt (DLI). The process begins when the ANTIC chip 
encounters a display list Instruction with its Interrupt bit (D7) set. ANTIC 
waits until the last scan line of the mode line It Is displaying. ANTIC then 
refers to Its NMIEN register to see if display list Interrupts have been 
enabled. If the enable bit Is clear, ANTIC Ignores the Interrupt and 
continues its regular tasks. If the enable bit Is set, ANTIC pulls down the 
NMI line on the 6502. ANTIC then goes back to its normal display activities. 
The 6502 vectors through the NMl vector to an interrupt service routine In 
the OS. This routine first determines the cause of the Interrupt. If the 
Interrupt Is Indeed a display list Interrupt, the routine vectors through 
addresses S0200, $0201 (lo then hi) to a DLI service routine. The DLI routine 
changes one or more of the registers which control the display. Then the 6502 
RTls to resume its mainline program. 

There are a number of steps involved In setting up a DLI. The very first 
thing you must do Is write the DLI routine itself. The routine must push any 
registers that will be altered onto the stack, as the OS poll routine saves 
no reglsrers. (The 6502 does automatically push the Processor Status Register 
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A simple program demonstrating a DLI Is given below: 

f I nd d Isp I ay I I si" 
Insert Interrupt Instruction 
loop for poking DLI service routine 



poke In Interrupt vector 
enab le DLI 

This routine uses the following assembly language DLI service routine: 



PHA 




save accumu I ator 


TXA 






PHA 




save X-reg Ister 


LDA 


#$30 


dark color for characters 


LDX 


#S58 


p Ink 


STA 


WSYNC 


wait 


STA 


C0LPF1 


store color 


STX 


C0LPF2 


store color 


PLA 




• 


TAX 






PLA 




restore reg I sters 


RT1 




done 



10 DL I ST*PEEK < 560 ) +256*PEEK ( 56 1 ) i REM 
20 POKE DLIST+15,130:REM 
30 FOR 1=0 TO 19:REM 
40 READ A:P0KE 1536+1 ,A:NEXT I 
50 DATA 72,138,72,169,80,152,88 
60 DATA 141,10,212,141,23,208 
70 DATA 141,24,208,104,170,104,64 
80 POKE 512,0:P0KE 513,6:REM 
90 POKE 54286, 192: REM 



This Is a very simple DLI routine. It changes the background color from 
blue to pink. It also changes the color of the characters so that they show 
up as dark against the pink background. One might wonder why the upper half 
of the screen remains blue even though the DLI routine keeps stuffing pink 
Into the color register. The answer Is that the OS vertical blank Interrupt 
routine keeps stuffing blue Into the color register during the vertical 
blank period. The blue color comes from the OS shadow register for that 
color register. Every hardware color register Is shadowed out to a RAM 
location. You may already know about these shadow registers at locations 708 
through 712. For most purposes you can change colors by poking values into 
the shadow registers. If you poke directly Into the hardware registers, the 
OS shadow process will wipe out your poked color within a 50th of a second. 
For DLI f S, however, you must store your new color values directly Into the 
hardware registers. You should not use a DLI to set the color of the first 
displayed line of the screen; the OS takes care of that line for you. Use 
DLI's to change colors of lines below the first line. 

By stuffing colors directly into the hardware registers you create a 
small problem: you defeat the automatic attract mode. Attract mcde Is a 
feature provided by the operating system. After nine minutes without a 
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keypress, the colors on the screen begin to cycle through random hues at 
lowered I urn? nances . This Insures that a computer left unattended for several 
hours dees not burn an Image Into the television screen. It Is easy to build 
attract mode Into a display list Interrupt. Only two lines of assembly code 
need be Inserted Into the DLI routine: 



OLD NEW 

LDA NEWCOL LDA NEWCOL 

STA WSYNC EOR COLRSH 

STA C0LPF2 AND DRKMSK 

STA WSYNC 
STA C0LPF2 



DRKMSK and COLRSH are zero page locations (S4E and S4F) set up and updated 
by the OS during vertical blank Interrupts. When attract mode Is not In 
force COLRSH takes a value of 00 and DRKMSK takes SFF. When attract mode Is 
in force, COLRSH Is given a new random value every four seconds and DRKMSK 
holds a value of $F5. Thus, COLRSH scrambles the color and DRKMSK lops off 
the highest luminance bit. 

The implementation of attract mode In DLl's exacerbates an already 
difficult problem: the shortage of execution time during a DLI. The DLI 
service routine has 15 machine cycles of execution time before horizontal 
sync. Between horizontal sync and the appearance of the electron beam on the 
left edge of the screen only 11 machine cycles are available. This is not 
enough time to load, attract, and store more than one color register. The 
solution is to load and attract the color values prior to horizontal sync, 
saving them In the A, X, or Y registers. Then the program stores the 
attracted color values immediately after the STA WSYNC. This solution works 
for up to 3 color registers (one each In A, X, and Y) . 

There are no simple options for the programmer who needs to change mere 
than three color registers In a single DLI. It might be possible to load, 
attract, and store a fourth color If that color Is not displayed on the left 
edge of the screen. Another approach Is to break one overactive DLI Into two 
less ambitious DLPs, each doing half the work of the original. The second 
DLI could be provided by Inserting a single scan line blank Instruction 
(with DLI bit set) Into the display list just below the main Interrupting 
mode line. This will of course consume seme screen space. 

Another partial solution Is to perform the attract chores during 
vertical blank periods. To do this, two tables of colors must be kept In 
RAM. The first table contains color values Intended to be displayed by the 
DLI routines. The second table contains the attracted values of these 
colors. During vertical blank, a user-supplied Interrupt service routine 
fetches each color from the first table, attracts It, and stores the 
attracted color to the second table. The DLI routine then retrieves values 
directly from the second table without the time penalty for attract. 
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It Is often desirable to have a number of DLI f s occurring at several 
vertical positions on the screen. This Is an Important way to add color to a 
display* Unfortunately, there Is only one DLI vector; If multiple DLI's are 
to be Implemented then the vectoring to the appropriate DLI must be 
Implemented In the DLI routine Itself, There are several ways to do this. If 
the DLI routine does the same process with different values then It can be 
table-driven. On each pass through the DLI routine a counter Is Incremented 
and used as an tndex to a table of values. A sample DLI routine for doing 
this Is as fol lows: 



PHA 






INC 


COUNTR 




LDA 


COUNTR 




STA 


WSYNC 


wait 


STA 


COLBAK 




CMP 


#$50 


1 asT 1 I ne? 


BNE 


ENDDL 1 


no , ex 1 1 


LDA 


/$00 


yes, reset counter 


STA 


COUNTR 


ENODL 1 PLA 




restore accumu 1 ator 


RT1 







The BASIC program to call this routine Is: 



10 GRAPHICS 7 

20 DL I ST=PEEK(560)+256*PEEK(561 ) :REM 

30 FOR 1=6 TO 85: REM 

40 POKE DLIST+I ,141 :REM 

50 NEXT I 

60 FOR 1=0 TO 23 

70 READ A:P0KS 1536+1 , A: NEXT! : REM 
80 DATA 72,233,32,6,173,32,6 
90 DATA 141,10,212,141,26,208 
100 DATA 201,80,208,5,169,0 
110 DATA 141,32,6,104,64 
120 POKE 512,0:P0KE 513,6:REM 
130 POKE 54286, 192: REM 



find display 1 1st 

give every mode line a DLI 

BASIC mode 7 with DLI bit set 



poke In DL! service routine 



vector to DLI service routine 
enable DLI 



This program will put 80 different colors onto the screen. 

There are other ways to Implement multiple DLI's. One way Is to use a 
DLI counter as a test for branching through the DLI service routines to the 
proper DLI service routine. This slows down the response of all the DLI's, 
particularly the ones at the end of the test sequence. Another way is to 
have each DLI service routine write the address of the next routine Into the 
DLI vector at S200, $201. This should be done after all graphics registers 
have been changed by the DLI routine. This is the most general solution to 
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the problem of multiple DL I f s . It has the additional advantage that 
vectoring logic Is performed after the time critical portion of the DL I # not 
before. 

One problem with DLI f s Is'the Interference between the OS keyboard 
click routine and DLI f s. Whenever a key Is pressed and acknowledged, the 
onboard speaker Is clicked. The timing for this click Is provided by a STA 
WSYNC Instruction. This can throw off the timing of a DLI routine and cause 
the screen colors to jump downward by one scan line for a fraction of a 
second. There Is no easy solution to this problem. One possible solution 
Involves the VCOL'NT register, a read-only register In ANTIC which tells what 
scan line ANTIC Is displaying. A DLI routine could examine this register to 
decide when to change a color. Another solution Is to disable the OS 
keyboard service routine and provide your own keyboard routine. This would 
be a tedious job. The final solution Is to accept no inputs from the 
keyboard. If keypresses are not acknowledged, the screen jiggle does net 
occur. 

The DLI was designed to replace a more primitive software/hardware 
technique called a kernel. A kernel Is a 6502 program loop which Is 
precisely timed to the display cycle of the television set. 3y monitoring 
the YCOUNT register and consulting a table of screen changes catalogued as a 
function of YCOUNT values, the 5502 can arbitrarily control all graphics 
values for the entire screen. A high price Is paid for this power: the 6502 
is not available for computations during the screen display time, which is 
about 75% of the time. Furthermore, no computation may consume more than the 
4000 or so machine cycles available during vertical blank and overscan 
periods. This restriction means that kernels can only be used with programs 
requiring little computation, such as certain skill and action games. For 
example, the BASKETBALL program for the ATARI 400/800 uses a kernel; the 
program requires little computation but much color. The multi-colored 
players In this game could not be done with display list Interrupts, because 
DLI ? s are keyed to playfield positions, not player positions. 

It Is possible to extend the kernel Idea right into a single scan line 
and change graphics registers on the fly. In this way a single color 
register can present several colors on a single scan line. The horizontal 
position of the color change Is determined by the amount of time that 
elapses before the change goes In. Thus, by carefully counting machine 
cycles the programmer can get more graphics onto the screen. Unfortunately, 
this Is extremely difficult to achieve In practice. With ANTIC DMA I ng the 
6502, It Is very difficult to know exactly how many cycles have really 
elapsed; a simple count of 6502 cycles fs not adequate. If ANTIC f s DMA Is 
turned off, the 6502 can assume full control of the display but must then 
perform all the work that ANTIC normally does. For these reasons horizontal 
kernels are seldom worth the effort. 

jhe tremendous value of graphics Indirection and all those modifiable 
registers tn the hardware now becomes obvious. With display list Interrupts, 
every one of these registers can be changed on the fiy. Ycu can put lots of 
color, graphics, and special effects onto the screen. The most obvious 
application of DLi f s Is to put more color onto the screen. Each coicr 
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register can be changed as many times as you have DLI's. This applies to 
both playfleld color registers and player color registers. Thus, you have up 
to nine color registers, each of which can display up to 128 different 
colors. Is that enough color for you? Of course, a normal program would not 
lend Itself to effectively using' all of those colors. Too many DLI's start- 
slowing down the whole program. Sometimes the screen layout cannot 
accomodate lots of DLI's. In practice, a dozen colors Is easy, two dozen 
requires careful planning, and more than that requires a contrived situation. 

DLI's can give more than color; they can also be used to extend the 
power of player-miss! le graphics. The horizontal position of a player can be 
changed by a DLL In this way a player can be repositioned partway down the 
screen. A single player can have several Incarnations on the screen, if you 
imagine a player as a vertical column with images drawn on It, a DLI becomes 
a pair of scissors with which you can snip the column and reposition 
sections of it on the screen. Of course, no two sections of the player can 
be on the same horizontal line, so two incarnations of the player cannot be 
on the same horizontal line. If your display needs allow graphics objects 
that will never be on the same horizontal line, a single player can do the 
job. 

Another way DLI's can be used In conjunction with players Is to change 
their width or priority. This would most often be used along with the 
priority masking trick described In Chapter 4. 

• 

The last application of DLI's Is the changing of character sets partway 
down the screen. This allows a program to use character graphics In a large 
window and regular text In a text window. Multiple character set changes are 
possible; a program might use one graphics character set at the top of the 
screen, another graphics character set In the middle of the screen, and a 
regular text character set at the bottom. A 'Rosetta Stone' program j*ou I d 
also be possible, showing different text fonts on the same screen. The 
vertical reflect bit can be changed with a DLI routine, allowing some text 
to be rights Ide up and other text to be upside down. 

The proper use of the DLI requires careful layout of the screen 
display. The designer must give close consideration to the vertical 
architecture of her display. The raster scan television system Is net 
two-dimensional I y symmetric; It has far more vertical structure than 
horizontal structure. The ATARI 400/800 display system was designed 
specifically for raster scan television, and It mirrors the anlsotropy of 
the raster scan system. The ATARI 400/300 display Is not a flat, blank sheet 
of paper on which you draw; It Is a stack of thin strips, each of which can 
take different parameters. The programmer who Insists on designing a flat 
display wastes many opportunities. You will achieve optimal results when you 
organize the Information you wish to d I sp I ay In a strong vertical structure. 
This allows the full power of the DLI to be brought to bear. 

Figure 5.1 shows some screen displays from various programs and gives 
estimates of the degree of vertical screen architecture used In each. 
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SPACE INVADERS 
(Trademark of Talto America Corporation) 

***L0TS*** 



SCRAM" 

(A Nuclear Reactor Simulation) 

I TTLE*** 




MISSILE COMMAND" STAR RAIDERS" 

***SCME*** ***L I TTLE*** 




GRAPH IT" 
***NONE*** 




ASTEROIDS" 
***NCNE*** 



Figure 5.1 

examples of vertical screen architecture 
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SCROLLING 



Quite frequently the amount of Information that a programmer wants to 
display exceeds the amount of Information that can fit onto the screen. One 
way of solving this problem Is to scroll the Information across the display. 
For example, listings of BASIC programs scroll vertically from the bottom to 
the top of the screen. All personal computers Implement this type of 
scrolling. However, the ATARI Personal Computer System has two additional 
scrolling facilities that offer exciting possibilities. The first Is f Load 
Memory Scan T (IMS) coarse scrolling; the second Is fine scrolling. 

Conventional computers use coarse scrolling; In this type of scrolling 
the pixels that hold the characters are fixed In position on the screen and 
text Is scrolled by moving bytes through the screen RAM. The resolution of 
the scrolling Is a single character pixel, which Is very coarse. The 
scrolling this produces Is jerky and quite unpleasant. Furthermore, It Is 
achieved by moving up to a thousand bytes around in memory, a slow and clumsy 
task. In essence, the program must move data through the playfleid to scroll. 

Some personal computers can produce a somewhat finer scroll by drawing 
Images In a higher resolution graphics mode and then scrolling these images. 
Although higher scrolling resolution Is achieved, more data must be moved to 
attain the scrolling and the program is consequently slowed. The fundamental 
problem is that the scrolling Is Implemented by moving' data through the 
screen area. 

There Is a better way to achieve coarse scrolling with the ATARI 
400/800: move the screen area over the data. The display list opcodes support 
a feature called Load Memory Scan. The LMS was first described In Chapter 2. 
The LMS Instruction tells ANTIC where the screen memory Is. A normal display 
list will have one LMS Instruction at the beginning of the display list; the 
RAM area It points to provides the screen data for the entire screen In a 
linear sequence. By manipulating the operand bytes of the LMS Instruction, a 
primitive scroll can be Implemented. In effect, this moves the playfleid 
window over the screen data. Thus, by manipulating just two address bytes, 
you can produce an effect Identical to moving the entire screen RAM. The 
following program does just that: 

find display list 
get low address of LMS operand 
get high address of LMS operand 
outer loop 

Inner I cop 
delay loop 



This program sweeps the display over the entire address space of the 
computer. The contents of the memory are all dumped onto the screen. The 



10 DLI ST=PEEK ( 560 ) +256*PEEK ( 56 1 ) : REM 
20 LMSL0W=QL!ST+4:R£M 

30 LMSHIGH»0L!ST+5:REM 
40 FOR l=0 TO 255: REM 
50 POKE LMSHIGH, I 
60 FOR J=0 TO 255: REM 
70 POKE LMSL0,J 
80 FOR Y«l TO 50:NEXT Y:R£M 
90 NEXT J 
100 NEXT i 
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program does that: 



10 GRAPHICS 0 # ■ , 

20 DLIST=PEEK(560)+256*PEEK(5o1) 

30 LMSL0W=0L I ST+4 
40 LMSH I GH=0L I ST+5 
50 SCREENL0W=0 

60 SCREENH i GH»0 , ,, Bfl 

70 SCR£ENL0W=SCREENL0W+40:REM next I ne 

80 IF SCRESNL0W<256 THEN GOTO 1 20 : REM overflow 

90 SCR£ENL0W=SCREENL0W-256:REM yes, adjust po,n,er 

100 SCREENH 1GH-SCREENH I GH+1 

110 IF SCREENH I GH 58 256 THEN END 

120 POKE LMSL0W,SCREENL0W 

130 POKE LMSH I GH, SCREENH I GH 

140 GOTO 70 

A pure Horizontal -o'l Is not so^ple to do as ^ 

sequence, with the bytes or one line '<™ e <>f* * * °" shi 9 f+ing al , the bytes 
previous line. We can horizontal «Y "roll the lines jy ^ +ne 
P to the left; this i s done by ec Renting , he LM S op. ^ w 

i?sriM n,us+ra+ed thts probiem * 

The solution Is to expanc 1 the scree, ^^^^S!* ^St^^ ,J 
series of Independent horizontal line data areas, ngure 
1 1 lustrates this Idea: 




Figure 6.1 
arranging screen RAM 
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On the left Is the normal arrangement, One-d I mens iona I serial RAM is stacked 
In linear sequence to create the screen data area. On the right Is the 
arrangement we need for proper horizontal scrolling. The RAM Is of course 
still one-dimensionai and still serial, but now It Is used differently. The 
RAM for each horizontal line extends much further than the screen can show. 
This Is no accident; the whole point of scrolltng Is to allow a program to 
display more Information than the screen can hold. We can't show all that 
extra Information If we don f t allocate the RAM to hold It. With this 
arrangement we can Implement true horizontal scrolling. We can move the 
screen window over the screen data without the undesirable vertical roll of 
the earlier approach. 

The first step In Implementing pure horizontal scroll Is to determine 
the total horizontal line length and allocate RAM accordingly. Next, we must 
write a completely new display list with an LMS instruction on each mode 
line. The display list will of course be longer than usual, but there Is no 
reason why we cannot write such a display list. What values do we use for the 
LMS operands? It is most convenient to use the address of the first byte of 
each horizontal screen data line, the points marked with x f s on the diagram. 
There will be one such address for each mode line on the screen. Once the new 
display list is in place, ANTIC must be turned onto It and screen data must 
be written to populate the screen. To execute a scroll, each and every LMS 
operand In the display list must be Incremented for a rlghtward scroll or 
decremented for a leftward scroll. Program logic must Insure that the Image 
does not scroll beyond the limits of the allocated RAM areas; otherwise, 
garbage displays will result. In setting up such logic, the programmer must 
remember that the LMS operand points to the first screen data byte in the 
displayed line. A displayed line will contain 10, 20, or 40 bytes of data. 
The maximum value of the LMS operand is then 10, 20, or 40 bytes short of the 
end of the data for the horizontal screen line. 

As this process is rather Intricate, let us work out an example. First, 
we must select our total horizontal line length. We shall use a horizontal 
line length of 256 bytes, as this will simplify address calculations. Each 
horizontal line will then require one page of RAM. Since we will use BASIC 
mode 2, there will be 12 mode lines on screen; thus, 12 pages or 3K of RAM 
will be required. For simplicity (and to guarantee that our screen RAM will 
be populated with nonzero data), we will use the bottom 3K of RAM. This area 
Is used by the OS and DOS and so should be full of Interesting data. To make 
matters more interesting, we'll put the display list onto page 6 so that we 
can display the display list on the screen as we are scrolling. The Initial 
values of the LMS operands will thus be particularly easy to calculate; the 
low order bytes will all be zeros and the high order bytes will be (in order) 
0, 1, 2, etc. The following program performs all these operations and scrolls 
the screen horizontally: 
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10 REM first set up the display list 

20 POKE 1536,112:REM 8 blank lines 

30 POKE 1537,112:REM 8 blank lines 

40 POKE 1538,1 12:REM 8 blank lines 

50 FOR 1*1 TO 12:REM loop to put In display list 

60 POKE 1536+3*1 ,71 : REM BASIC mode 2 with LMS set 

70 POKE 1536+3*1+1 ,0:REM low byte of LMS operand 

80 POKE 1536+3*1+2, I: REM high byte of LMS operand 

90 NEXT I 

100 POKE 1575,65:REM ANTIC JVB Instruction 

110 POKE 1576,0: REM display list starts at $0600 

120 POKE 1577,6 

130 REM tell ANTIC where display list is 
HO POKE 560,0 
150 POKE 561,6 

160 REM new scroll horizontally 

170 FOR 1=0 TO 23 5: REM loop through LMS low bytes 

175 REM we use 235 not 255 because screen width Is 20 characters 

180 FOR J-1 TO 12:REM for each mode line 

190 POKE 1536+3*J+1 , I : REM put In new LMS low byte 

200 NEXT J 
210 NEXT I 

220 GOTO 170: REM endless loop 

This program scrolls the data from right to left. When the end of a page 
Is reached It simply starts over at the beginning. The display list can be 
found on the sixth line down (it's on page six). It appears as a sequence of 
double quotation marks. 

The next step Is to mix vertical and horizontal scrolling to get 
diagonal scrolling. Horizontal scrolling Is achieved by adding 1 to or 
subtracting 1 from the LMS operand. Vertical scrolling Is achieved by adding 
the line length to or subtracting the line length from the LMS operand. 
Diagonal scrolling is achieved by executing both operations. There are four 
possible diagonal scroll directions. If, for example, the line length is 256 
bytes and we wish to scroll down and to the right, we must add 256+<-1)-255 
to each LMS operand tri the display list. This Is a two-byte add; the BASIC 
program example given above avoids the difficulties of two-byte address 
manipulations but most programs will not be so contrived. For truly fast 
two-dimensional scrolling assembly language will be necessary. 

All sorts of weird arrangements are possible if we differentially 
manipulate the LMS bytes. Lines could scroll relative to each other, or hop 
over each other. Of course, some of this could be done with a conventional 
display but more data would have to be moved to do it. The real advantage of 
LMS scrolling Is Its speed. Instead of manipulating an entire screenful of 
data, many thousands of bytes In size, a program need only manipulate two or 
perhaps a few dozen bytes. 
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FINE SCROLLING 

The second Important scrolling facility of the ATARI 400/300 Is the fine 
scrolling capability. Fine scrollfng Is the capability of scrolling a pixel 
In steps smaller than the pixel size. Coarse scrolls proceed In steps equal 
to one pixel dimension; fine scrolls proceed In steps of one scan line 
vertically and one color clock horizontally. Fine scrolling can only go as 
far as one pixel; to get full fine scrolling over distance greater than one 
pixel we must couple fine scrolling with coarse scrolling. (Throughout this 
chapter the term pixel refers to an entire character, not to the smaller dots 
which make up a character.) 

There are only two steps to Implement fine scrolling. First, we set the 
fine scroll enable bits In the mode bytes of the mode lines for which we want 
fine scrolling. (In most cases we want the entire screen to scroll so we set 
all the scroll enable bits In all the mode bytes.) Bit D5 of the display 
Instruction Is the vertical scroll enable bit; bit D4 of the display 
Instruction Is the horizontal scroll enable bit. We then store the scrolling 
value we desire Into the appropriate scrolling register. There are two 
scrolling registers, one for horizontal scrolling and one for vertical 
scrolling. The horizontal scroll register (HSCROL) Is at $0404; the vertical 
scroll register (VSCROL) Is at SD405. For horizontal scrolling, we store the 
number of clocks by which we want the line scrolled Into HSCROL. For vertical 
scrolling, we store the number of scan lines that we want the line scrolled 
by Into VSCROL. These scroll values will be applied to every line for which 
the respective fine scroll is enabled. 

There are two complicating factors that we encounter when we use fine 
scrolling. Both arise from the fact that a partially scrolled display shows 
more information than a normal display. Consider for example what happens 
when we horizontally scroll a line by half a character to the left. There are 
40 characters In the line. Half of the first character disappears off of the 
left edae of the screen. The 40th character scrolls to the left. What takes 
Its place? Half of a new character should scroll In to take the place of the 
now scrolled 40th character. This character would be the 41st character. But 
there are only 40 characters In a normal line; what happens? If we have 
implemented coarse scrolling then the 41st character suddenly appears on the 
screen after the first character disappears off of the left edge. This sudden 
appearance Is Jerky and unsightly. The solution to this problem has already 
been built Into the hardware. There are three display options for line 
widths: the narrow playfield (128 clocks wide), the normal playfield (160 
clocks wide) and the wide playfield (192 clocks wide). These options are set 
by setting appropriate bits In the DMACTL register. When using horizontal 
fine scrolling, ANTIC retrieves more data from RAM than It displays. For 
example, If DMACTL Is set for normal playf leid, which In BASIC mode 0 has 40 
bytes per line, then ANTIC will actually retrieve dat3 at a rate appropriate 

to wide playfield 48 bytes per line. This will throw lines off horizontally 

if It Is not taken Into account. The problem does not manifest itself If the 
programmer has already organized screen RAM into long horizontal lines as In 
Figure 6.1 . 

The corresponding problem for vertical scrolling can be handled In 
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either of two ways. The sloppy way Is to gnor e It. Then we wll I not get 
ha If- 1 mages at both ends of the display. Instead, the Images at the bottom or 
the display will not scroll In properly; they will suddenly pop nto view. 
The proper way takes very little work. To get proper fine scrolling Into and 
out of the display region we must dedicate one screen line to act as a 
buffer. We do this by refraining from setting the vertical scroll bit n the 
display list Instruction of the last mode line of the vert I ca I y scro 1 1 ed 
zone. The line will still scroll, but without the unpleasant Jerk. The screen 
Image will be effectively shortened by one mode line vertlca ly. An advantage 
of scrolling displays now becomes apparent. It Is quite poss ble to create 
screen Images that have more than 192 scan lines In the display. This could 
be disastrous with a static display, but with a scrolling display Images 
which are above or below the displayed region can always be scrolled Into 
view . 

Fine scrolling willonly scroll to the limits of the pixel size. I f we 
a++ o mo t to scroll beyond the dimensions of a single pixel, odd results will 
ensue. If we attempt to scroll too far vertlcaly ANTIC will become confused 
and the screen may Jump about unpleasantly. Apparently ANTIC can scroll up to 
16 color clocks horizontally without III effect; beyond this the upper four 
blts of HSCROL are Ignored by ANTIC. To get full fine scrolling (In which the 
entire screen smoothly scrolls as far as we wish) we must couple flne^ 
scrolling with coarse scrolling. To do this we first fine scrol I the image, 
keeping track of how far It has been scrolled. When the amount of fine 
scrolling equals the size of the pixel, we reset the fine scroll regis, er .o 
zero and execute a coarse scroll. Figure 6.2 Illustrates the process: 



ont step 




start f i ne 
position scroll 



once 



fine 

scro I I 
twice 



fine 

scrol I 
thrice 



fine 
scrol I 

four 
times 



fine 
scrol I 

five 
times 



fine 
scrol I 

six 
times 



fine 
scrol I 
seven 
times 



reset 
to 

start 
position 



and 

coarse 
scro I I 



Figure 6.2 
linking fine scroll to coarse scroll 
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The following program Illustrates simple fine scrolling: 



10 GRAPHICS 0 

20 DLIST=PEEKC560)+256*PEEK(561 ) 

30 POKE DLIST+10,50:REM 

40 POKE DUST+1 1,50: REM 

50 FOR Y=0 TO 7 

60 POKE 54277, Y: REM 

70 NEXT Y 

80 FOR X=0 TO 3 

90 POKE 54276, X: REM 

100 NEXT X 

110 GOTO 40 



The applications of full fine scrolling for graphics are numerous. The 
obvious application Is for large maps which are created with character 
graphics. Using BASIC Graphics mode 2 I have created a very large map of 
Russia which contains about 10 screenfuls of image. The screen becomes a 
window to the map. The user can scroll about the entire map with a joystick. 
The system Is very memory efficient; the entire map program plus data plus 
display list and character set definition requires a total of about 4K of RAM. 

There are many other applications of this technique. Any very large 
image that can be drawn with character graphics Is amenable to this system. 
(Scrolling dees not require character graphics. Map graphics are net 
particularly necessary when scrolling is available.) Large electronic 
schematics could be presented In this way. The joystick could be used both to 
scroll around the schematic and to Indicate particular components that the 
user wishes to address. Large blueprints or architectural diagrams could also 
be displayed with this technique. Any big Image that need not be seen In Its 
entirety can be presented with this system. 

Large blocks of text are also usable here, although It might not be 
practical to read continous blocks of text by scrolling the image. This 
system Is more suited to presenting blocks of Independent text. One 
particularly exciting idea Is to apply this system to menus. The program 
starts by presenting a welcome sign on the screen with signs Indicating 
submenus pointing to other regions of the larger Image. 'This way to 
addition' could point up while 'this way to subtraction' might point down. 
The user scrolls around the menu with the Joystick, perusing his options. 
When he wishes to make a choice, he places a cursor on the option and presses 
the red button. Although This system could not be applied to all programs, it 
could be of great value to certain types of programs. 

There are two 'blue sky' applications of fine scrolling which have not 
yet been fully explored. The first Is selective fine scrolling, in which 
different mode lines of the display have different scroll bits enabled. 
Normally we would want the entire screen to scroll, but It is not necessary 
to do so. We could select one line for horizontal scrolling only, another 
line for vertical scrolling only, and so forth. The second blue sky feature 



enable both scrol Is 

do It for two mode lines 

vertical scrol I 
horizontal scrol I 
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Is the prospect of using display list Interrupts to change the HSCROL or 
VSCROL registers on the fly. Changing VSCROL on the fly is a tricky 
operation; It could confuse ANTIC and produce undesirable results. Changing 
HSCROL Is much safer. 
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ATARI BASIC OVERVIEW 



This chapter discusses the ATARI BASIC. The four main topics are: 

1. What is ATARI BASIC - a description of what is required to make 
BASIC run, and a discussion of its strengths and weaknesses. 

2. How ATARI BASIC Works - a detailed analysis of hew programs are 
tokenizea ana executed. 



3. Improving Program Performance - a list of methods to increase 
the speed of a program ana decrease its size. 

4. Advanced Programming Techniques - a series of custom applications 
or "tricks" to meet various programming needs. 



ATARI BASIC 



What Is ATARI BASIC 



ATARI BASIC is li*s other B ASICs in 

an 8K ROM cartridge in ^ ^eft slot of th e CO mp . p RftM and 

addresses A000 through BFFF. BAblu . 
at least one BK RAM board is required for this. 

To use ATARI BASIC effectively one ^ J™ ^g^tSS Take good 
weaknesses. With this information programs can be written 

use of the assets and features of ATARI BASIC. 



Strengths of ATARI BASIC: 



1. 



2. 



3. 



4. 



5. 



6. 



It supports the operating system graphics - jimple graphics 
calls can be made to display information on the scrsen. 

It supports the hardware - such calls as SOUNDjSTICK and PADDLE 
are simple interfaces to the hardware of the computer. 

Simple assembly interface - the USR function allows easy user 
access to assembly language routines. 

rhm based interpreter - the BASIC interpreter is in ROM, which 
pSevents'accidental modification by the user program. 

DOS support - specialized calls such as NOTE and POINT (DOS 
2. OS) allow the user to randomly access a disk cnru y 
operating system. 

Peripheral support - any peripheral recognized by the operating 
sysreS can beaccessed from a BASIC program. 



Weaknesses of ATARI BASIC: 

u no suooort of integers - all numbers are stored as six byte BCD 
floating point numbers. 

^ ^,„a vnre all numbers are six bytes long, math 
2 Slow math package - s^nce an nuu.u 

operations become rather slow. 
3. No string arrays - on!y <,ne-di„ensi=nal strings can be created. 
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How ATARI BASIC Works 

A brief overview of the workings -of the BASIC interpreter is as follows: 

1. BASIC gets a line of input from the user and converts it into a 
tokenized form. 

2. It then puts this line into a token program. 

3. This program is then executed. 

The details of these operations are discussed in the following four sections. 

A. THE TOKENIZING PROCESS 

B. THE TOKEN FILE STRUCTURE 

C. THE PROGRAM EXECUTION PROCESS 

D. SYSTEM INTERACTION 



ATARI BASIC 



A. THE TOKENIZING PROCESS 

,„ simple ter.s, the Ionization of a line of eode in BASIC loo.a 
like this: 



1 . 
2. 
3. 
4. 

5. 



BASIC gets a line of input 
It then checks for legal syntax 
nurina svntax checking it is tokenized 
Z tokenized line is moved into the token program 
If the line is in immediate mode it is executed 



Token 
Statement 



To better understand the tokenizing process some terms must first be 
defined. These are: 

. an 8 bit byte containing a particular interpretable code. 

mni*^ "sentence" of tokens that causes BASIC to perform 
" UTSSSUfS* task. °ln LIST form, statements are separated 
by colons. 

one or more statements preceeded either by a line "umber in 
" the range of 0 to 32767, or an immediate mode line with no 
number • 

. the first executable token of a statement that : tells BASIC to 
interpret the tokens that follow in a particular way. 

a token that is an indirect pointer to its actual value; thus 
the value can be changed without changing the token. 



Line 



Command 



Variable - 



Constant - 



Operator - 



a six byte BCD value preceeded by a special token. This value 
remains unchanged throughout program execution. 

any one of 46 tokens that in some way move or modify the 
values that follow them. 



Function 
EDL 



_ a token that when executed returns a value to the program. 
- "End of Line", a character with the value 9B Hex. 



BASIC begins the tokenizing {^^^i^^t^" 
input will be obtaineo from one of the handlers o - the op gjr ^ 

Normally it is from the «™ i a a GET RECORD command, 

device can be specified. The cal J °AbiL terminated by a n EOL. This 

data's JfiTSo StS'SWlSriln. buffer from 580 to 5PF 
Hex. 
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After the record is returned the syntax checking and tokenizing 
processes begin. First BASIC looks for a line number. If one is found it 
is converted into a two byte integer. If no line number is present it is 
assumed to be in immediate mode and the line number 8000 Hex is assigned 
to it. These will be the first two tokens of the tokenized line. This 
line is built in the token output buffer that is 256 byte long and resides 
at the end of the reserved operating system RAM. 

The next token is a dummy byte reserved for the byte count (or 
offset) from the start of this line to the start of the next line. 
Following that is another dummy byte for the count of the start of this 
line to the start of the next statement. These values will be set when 
tokenization is complete for the line and the statement respectively. The 
use of these values is discussed in the program execution process section. 

BASIC now looks for the command of the first statement of the input 
line. A check is made to determine if this is a valid command by scanning 
a list of legal commands in ROM. If a match is found then the next byte 
in the token line becomes the number of the entry in the ROM list that 
matched. If no match is found a syntax error token is assigned to that 
byte and BASIC stops tokenizing, copies the rest of the input buffer in 
ATASCII format to the token output buffer, and prints the error line. 

Assuming a good line, following the command can be one of seven 
items: a variable, a constant, an operator, a function, a double quote, 
another statement, or an EOL. BASIC tests if the next input character is 
numeric. If not then it compares that character and those following 
against the entries of the variable name table. If this is the first line 
of code entered in the program then no match will be found. The characters 
are then compared against the function and operator tables. If no match 
is found there then BASIC assumes that this is a new variable name. Since 
this is the first variable it will be assigned the first entry in the 
variable name table. The characters are copied out of the input buffer 
and stored into the name table with the most significant bit (MSB) set on 
the last byte of the name. Eight bytes are then reserved in the variable 
value table for this entry. (See the variable value table discussion in 
the token file structure section.) 

The token that ends up in the tokenized line is the variable number 
minus one, with the MSB set. Thus the token of the first variable entered 
would be 80 Hex, the second would be 81, and so on up to FF for a total of 
128 unique variable numbers. 

If a function is found, then its entry number in the operator function 
table is assigned to the token. Functions require certain sequences of 
parameters; these are contained in syntax tables, and if they are not 
matched then a syntax error will result. 

If an operator is found, then a token is given its table entry number. 
Operators can follow each other in a rather complex fashion -(such as 
multiple parentheses) so the syntax checking of them is a bit complicated. 
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In the case of the double quotes, BASIC assumes that a character 
string is following and assigns a OF Hex to the output token and reserves 
a dummy byte for the string length. The characters are moved from the 
input buffer into the output buffer until the second set of quotes is 
found. The length byte is then set to the character count. 

If the next characters in the input buffer are numeric, BASIC will 
convert them into a six byte BCD constant. A C£ Hex token will be put in 
the output buffer, followed by the six byte constant. 

When a colon is encountered, a 14 Hex token is inserted in the output 
buffer and the offset from the start of the line is stored in the dummy 
byte that was reserved for the count to the start of the next statement. 
At this point another dummy byte is reserved and the process goes back to 
get a command. 

When the EOL is found, a 16 Hex token is stored and the offset from 
the start of the line is put in the dummy byte for the line offset. At 
this point tokenization is complete and BASIC will move the token line 
into the token program. First it searches the program for that line 
number. If it is found it replaces the old line with the new one. If it 
is not found then the new line is inserted in the correct numerical 
sequence. In both cases, the data following the line will either be moved 
up or down in memory to allow for an expanding and contracting program 
size. 

BASIC now checks if the tokenized line is an immediate mode line. 
If so, that line is executed according to the methods described in the 
interpretive process, if not then BASIC goes back to get another line of 
input. 

If at any time during the tokenizing process the length of the token 
line exceeds 256 bytes, an error 14 message (line too long) is sent to the 
screen and BASIC will go back to get the next line of input. 

An example line of input and its token form looks like this (all 
token values are hexadecimal) : 

10 LET X=1 : PRINT X 



OA 00 13 OF 06 80 2D 0E 40 01 00 00 00 00 14 13 20 80 22 
A A AAA A 



Line 10 



Line 
Offset 



Let 



1 



End of Line 
X 



Numeric 
Constant 



Statement 
Offset 



Statement 
Offset 



End 
Of 

Statement 
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COMMANDS 



OPERATORS 



FUNCTIONS 



HEX DEC 



HEX DEC 



HEX DEC 



00 


0 


REM 


OF 


14 


Tkiiim con^t! 


70 61 




1 

1 


DATA 


DP 
ur 


1 5 




7P 69 


02 


2 


I NPUT 

1 1 '1 W 1 


10 


16 

1 w 


n 


7F 67 


03 


3 


COLOR 


1 1 

1 1 


17 




40 64 

*r\J w*t 


04 

W ~ 


4 


Li ST 


12 


1 8 


t 


41 65 


05 


5 


ENTER 


13 


19 




42 66 

*TJL WW 


06 

W W 


6 

w 


LET 


14 


20 


• TSTMT ENDl 

• L»w 1 ™i i yiu j 


43 67 


07 


7 


i r 


15 


21 


• 


44 6ft 


Oft 


q 
o 


FDR 


1 ^ 

1 0 


92 
ZZ 


n i wp Pwnl 


43 oy 




Q 


NFXT 


17 


23 




A6 70 
4u / U 


DA 


1 0 


GOTO 

WW J VJ 


1 ft 




WJCUD 


Al 71 

4 / /I 


OR 


1 1 

1 1 


GO TO 
wv i w 


1 Q 


25 


TP, 


Aft 79 


OC 


12 


GO^UR 

WWW WW 


1 A 


26 


w I cr 


ZQ 77 


0D 


13 


TRAP 


1B 

I w 


27 


THEN 


4A 74 


0E 

w La 


1 4 


BYE 
— — 


1C 

• w 


28 


% 


4R 75 


OF 


15 


C0NT 

W W 1 ' 1 


1D 

1 w 


29 


<= Tnum^ricsI 


4C 76 

*TW / W 


10 


16 

1 w 


COM 

WW 1 I 


1 F 


30 

^ w 


<> 


40 77 


1 i 
i i 


17 


CLO^F 


1 F 

i r 


31 


>ss 


ZF 7ft 

4C / w 


1 2 


1 ft 


CI P 

wLA 


mL J 


79 
JZ 




ZP 7Q 

4r / ^ 




1 Q 




21 


77 
J J 


s 
s 


3U OU 


1 A 




n i m 


ZZ 


7A 




5 1 ft 1 

3 1 OS 


1 5 

i 3 


21 


FND 


23 


7^ 


0 


5 9 ft9 


16 

1 W 


22 

fa Am 


NEW 


24 


36 

— ' w 




53 83 


17 


25 

Am 0 


OPEN 

Wl w ' < 


25 


37 




54 84 

^ t W"T 


18 


24 


LOAD 

mm \ mm 


26 


38 






19 


25 


SAVE 


27 


39 


/ 




1A 


26 


STATUS 


28 


40 


NOT 




1B 


27 


NOTE 

■ ™ mtr mm 


29 


41 


OR 




JC 


28 


POINT 

• Willi 


2A 


42 


AND 




1D 

I w 


29 


X! 0 

/> I w 


2B 


43 


( 




i p 


30 


CM 

WM 


2P 


zz 






1 F 

I r 


T1 

J 1 


rvrvC 


ZiJ 


A5 


- f ad 1TWM AC^ICKil 
■ LaK 1 i niM Aww i uPi J 




9A 
ZU 


79 
-3Z 


DO 1 KfT 

rK I N 1 


Zc 


40 


— L*3 i K I Nb Moo 1 bNJ 




91 


77 


PAD 


2F 


Z7 


v» l.0 1 A i rivjoj 




22 


34 


ACA2J 




4w 






23 


35 


ACO 1 w AC 


3 1 


4Q 


>= 




24 




AC 1 UAJN 


32 
— 




< 






37 


P! IN 


33 


51 
* 


> 




26 


o 


^TCP 

O 1 vr 


34 


52 


s 




Z / 


7 Q 


DAD 

rUr 






+ C UNARY J 




9ft 
ZC 


AD 
4U 


* 




34 






29 


4 i 


GET 


37 


55 


( [STRING LEFT PAREN] 


Za 


4Z 


Qt IT" 




30 


( [ARRAY LEFT PARENJ 




Zd 


4.5 






J? "7 

D / 


( [DIM ARRAY LEFT PARENJ 


Zu 


44 


PLOT 




5o 


( LFUN LEFT PARENj 




9n 


43 


r\Jo i 1 I UN 






( [DIM STR LEFT PARENj 


9P 

-~ 


.16 




-)w 


6H 

WW 


, [ARRAY COMMA] 




9P 


AH 
4 / 


UKnn 1 U 










7A 


AP 


cctpoi no 










7 1 

^ 1 


ZQ 


1 DCATP 










32 


50 


SOLT^D 










33 


51 


LPRINT 










34 


52 


CSAVE 










35 


53 


CL0AD 










36 


54 


[IMPLIED LET j 










37 


55 


ERROR- [SYNTAX] 











STRS 

CHR$ 

USR 

ASC 

VAL 

LEN 

ADR 

ATM 

COS 

PEEK 

SIN 

RND 

FRE 
EXP 

LOG 
CLOG 

SCR 
SGN 

ASS 
INT 

PADDLE 
STICK 
FTRIG 
STRIG 
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B. THE TOKEN FILE STRUCTURE 

The token file contains two major segments: 1) • f^P^ "J 0 ^ 
pointers that point into the token file an 2) th actua to 
itself. The zero P»9%P? inte " "J^^^^e pointers and they are 

^icTtionVSS toll Si!" £^»7££# - and the 

sections of the token file they reference. 



POINTER (Hex) 
LOMEM 80,81 



VNTP 82,83 



VNTD 84,85 



VVTP 86,87 



T OKEN FILE SECTION (Contipuo us Blocks) 

Token output buffer - this is the buffer BASIC uses 
T t°o tokenize one line of code. It is 256 bytes long. 
This buffer resides at the end of the operating 
system's allocated RAM. 

Variable Name Table - a list of all the variable names 
that have been entered in the program. They are 
Sored as ATASCII characters, eacn new name stored in 
the order it was entered. Three types of name entries 

"^Scalar variables - MSB set on last character in name 

2. String variables - last character is a with the 

3. ^"variables - last character is a with the 
MS3 set. 

Variable Name Table dummy end - BASIC uses this 
pointer to indicate the end of the name table. This 
normally points to a dummy zero byte when there are 
less than 128 variables. When 128 variables are 
present, this points to the last byte of the last 
variable name. 

Variable Value Table - this table contains current 
information on each variable. For each variable in 
the name table, 8 bytes are reserved in the vaiue 
table. The information for eacn variable type is. 



BYTE NUMBER 



1 I 2 



I 5 



I 7 



8 




SCALAR 



Six bvte BCD constant 




ARRAY (DIMed) 41 I 
(unOIMed) 40 I 



Var#i Offset from ! first I 
|qTARP(8C.8D) l DIM + 1 




second 
DIM + 1 



STRING (DIMed) 81 1 
(unDI Med) 80 ! 

A scalar 
is X=1 . 
six byte 
elements 
entry in 
cnaracte 
one entr 



VarfM Offset from I Length 
lSTARP(8C,3D) I 



I 



variable contains a numeric value. An example 
The scalar is X and its value is 1 , stored in 
BCD format. An array is composed of numeric 
stored in the string/array area and has one 
the value table. A string, composed of 

r elements in the string/array area, also has 

y in the table. 
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The first byte of each value entry indicates the type 
of variable: 00 for a scalar, 40 for an array, and 80 
for a string^ If the array or string has been dimen- 
sioned, then the LSB is set on the first byte. 

The second byte contains the variable number. The 
first variable entry is number zero and if 128 variables 
were present the last would be 7F. 

In the case of the scalar variable the third through 
eighth byte contain the six byte BCD number that has 
currently been assigned to it. 

For arrays and strings, the third and fourth bytes 
contain an offset from the start of the string/array 
area (described below) to the beginning of the data. 

The fifth and sixth bytes of an array contain its 
first dimension. The quantity is a two byte integer 
and its value is 1 greater than the user entered. The 
seventh and eighth bytes are the second dimension, 
also a value of 1 greater. 

The fifth and sixth bytes of a string are a two byte 
integer that contains its current length. The seventh 
and eighth bytes are its dimensions. 

Statement Table - this block of data includes all the 
lines of code that have been entered by the user and 
tokenized by BASIC, and it also includes the immediate 
mode line. The format of these lines is described in 
the tokenized line example of the section on the 
tokenizing process. 

Current Statement - this pointer is used by BASIC to 
reference particular tokens within a line of the 
statement table. When BASIC is waiting for input, 
this pointer is set to the beginning of the immediate 
mode line. 

String/Array area - this block contains all the 
string and array data. String characters are stored 
as one byte ATASCII entries, so a string of 20 character 
will require 20 bytes. Arrays are stored with 6 byte 
BCD numbers for each element. A 10 element array will 
require 60 bytes. 

This area is allocated and subsequently enlarged 
by each dimension statement encountered, the amount 
being equal to the size of a string dimension or six 
times the size of an array dimension. 



ATARI BASIC 
POINTER (Hex) 



TOKEN FILE SECTION (Contiguous Blocks) 



RUNSTK 8E,8F Run Time Stack - this software stack contains GOSUB 

and FOR/NEXT, entries. The GOSUB entry consists of 
four bytes. The first is a 0 byte indicating GOSUB, 
followed by the two byte integer line number on which 
the call occured, followed by the offset into that 
line so the RETURN can come back and execute the next 
statement* 

The FOR/NEXT entry contains 16 bytes. The first is 
the limit the counter variable can reach. The second 
byte is the step or counter increment. Each of these 
quantities is in 6 byte BCD format. The thirteenth 
byte is the counter variable number with the MSB set, 
the fourteenth and fifteenth bytes are the line 
number, and the sixteenth is the line offset to the 
FOR statement. 

MEMTOP 90,91 Top of Application RAM - this is the end of the user 

program. Program expansion can occur from this point 
to the end of free RAM, which is defined by the start 
of the display list. The FRE function returns the 
amount of free RAM by subtracting MEMTOP from HIMEM 
(2E5,2E6). Note that the BASIC MEMTOP is not the same 
as the OS variable called MEMTOP. 
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C. THE PROGRAM EXECUTION PROCESS 

The process of executing a line of code involves reading the tokens 
that were created during the tokenization process. Each token has a 
particular meaning that causes BASIC to execute a specific series of 
operations. The method of doing 'this requires that BASIC get one token at 
a time from the token program and then process it. The token is an index 
into a jump table of routines, so a PRINT token will point indirectly to a 
PRINT processing routine. When that processing is complete, BASIC returns 
to get the next t ken. The pointer that is used to fetch each token is 
called STMCUR and is at 8A and 8B. 

The first lire of code that is executed in a program is the immediate 
mode line. This is usually a RUN or GOTO. In the case of the RUN, BASIC 
gets the first line of tokens from the statement table (tokenized program) 
and processes it. If all the code is in-line, then BASIC will merely 
execute conse.utive lines. 

If a GOTO is encountered, then the line to go to must be found. The 
statement table contains a partially linked list of line numbers and state- 
ments, the lowest line number first, followed by increasing line numbers 
up to the largest. If a line somewhere in the middle of the table is needed, 
the process is as follows: 

The address of the first line is found in the STMTAB pointer 
at 88 and 89. This is stored in a temporary pointer. The 
first two bytes of the first line are its line number. This 
number is compared against the requested line number. If the 
first number is less, then BASIC gets the next line by adding 
the third byte of the first line to the temporary pointer. 
The temporary pointer will be pointing to the second line. 
Again the first two bytes of this new line are compared to 
the requested line, and if they are less, the third byte is 
added to the pointer. If a line number does match, then the 
contents of the temporary pointer are moved into STMCUR and 
BASIC will fetch the next token from the new line. Should the 
requested line number not be found, then an Error 12 will be 
generated. 

The GOSUB involves more processing than the GOTO. The line finding 
routine is the same, but before BASIC goes to that line it sets up an 
entry in the Run Time Stack. It allocates four bytes at the end of the 
stack and stores a 0 in the first byte to indicate a GOSUB stack entry. 
It then stores the line number it was on when the call was made into the 
next two bytes of the stack. The final byte contains the offset in bytes 
from the start of that line to where the GOSUB token was found. BASIC 
then executes the line it looked up. When the RETURN is found, the entry 
on the stack is pulled off, and BASIC returns to the calling line. 

The FOR command causes 3ASIC to allocate 16 bytes on the Run Time 
Stack. The first six bytes are the limit the variable can reach in six 
byte BCD format. The second six bytes are the step, in the same format. 
Following these, BASIC stores the variable number (MSB set) of the counting 
variable. It then stores the present line number (2 bytes) and the offset 
into the line. The rest of the line is then executed. 
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When BASIC finds the NEXT command, it looks at the last entry on the 
stack. It makes sure the variable referenced by the NEXT is the same as 
the one on the stack and cnecks if the counter has reached or exceeded the 
limit. If not then BASIC returns to the line with the FOR statement and 
continues execution. If the limit was reached then the FOR entry is 
pulled off the stack and execution continues from that point. 

When an expression is evaluated, the operators are put onto an 
operator stack and are pulled off one at a time and evaluated. The order 
in which the operators are put onto the stack can either be implied, in 
which case BASIC looks up the operator's precedence from a ROM table, or 
the order can be explicitly stated by the placement of parentheses. 

If at any time the BREAK key is hit, the operating system sets a flag 
to indicate this occurrence. BASIC checks this flag after each token is 
processed. If it finds it has been set, it stores the line number at 
which this occured, prints out a "STOPPED AT LINE number" message, clears 
the BREAK flag and waits for user input. At this point the user could 
type CONT and program execution would continue at the next line. 
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D. SYSTEM INTERACTION 



BASIC communicates with the operating system primarily through the 
use of I/O calls to the Central I/O Utility (CIO). Following is a list of 
user BASIC calls and the corresponding operating system IOCBs. 

BASIC • OS 



OPEN #1,12,0,"E: M IOCBsl 

Command=3 (OPEN) 
Aux1=12 (Input/Output) 
Aux2=0 

Buffer Address=ADR("E:") 

GET #1 f X IOCBsl 

Commands 7 (Get Characters) 
Buffer LengthsO 

Character returned in accumulator 
IOCBsl 

Commands! 1 (Put Characters) 
Buffer LengthsO 

Character output through accumulator 
IOCBsl 

Command=5 (Get Record) 

Buffer LengthsLength of A$ (not over 120) 
Buffer Address=Input Line Buffer 

PRINT #1,A$ IOCBsl 

BASIC uses a special put byte vector 
in the IOCS to talk directly to the 
handler. 

XIO 18, #6,12,0, W S: M ' I0CB=6 

Command=18 (Special - Fill) 

Aux1=12 

Aux2=0 

SAVE/LOAD: When a BASIC token program is SAVEd to a device, two 
blocks of information are written. The first block consists of seven of 
the nine zero page pointers that BASIC uses to maintain the token file. 
These are L0MEM(80,81) through STARP (8C,8D). There is one change made to 
these pointers when they are written out: The value of LOMEM is subtracted 
from each of the two-byte pointers, and these new values are written to 
the device. Thus tne first two bytes written will be 0,0. 

The second block of information written consists of the following 
token file sections: 1) The variable name table, 2) the variable value 
table, 3) the token program, and 4) the immediate mode line. 

When this program is LOADed into memory, BASIC looks at the OS 
variable MEMLO (2E7,2E8) and adds its value to each of the two-byte zero 
page pointers as they are read from the device. These pointers are placed 
back on page zero and then the values of RUNSTK (8E,8F) and MEMTOP (90,91) 
are set to tne value in STARP . 



PUT #1,X 



INPUT #1,A$ 
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Next, 256 bytes are reserved in «jwy above tne value of iCUl^ 
ellocate space for the token ™tP£>'"«; t £°Cgn t h. ".mediate »od= 

sis: m^'tSS sa'S'piSd^-ss J-*-* f ° u °- in9 tne 

token output buffer. 



OS 



RAM 



BASIC 



MEMLC 2E7,2E8_ 



APPMHI 0E,0F 



MEMTOP 2E5,2E6 
SDL ST 230,231 



SAVMSC 58,59 



TXTMSC 294,295 



RAMTOP 6A 
RAMS I Z 2EA 



PAGE 
SIX 



BASIC 
TOKEN 
PROGRAM 



FREE 
RAM 



DISPLAY 
LIST 



SCREEN 
RAM 



TEXT 
WINDOW 



30,81 
"82,83 
84,85 
"86,87 
"88,89 
"8A,8B 
"8C,8D 
"8E,8F 
"90,91 
0E,0F 



2E5,2E6 



LOMEM 

VNTP 

VNTD 

VVTP 

STMTAB 

STMCUR 

STARP 

RUNSTK 

MEMTOP 

APHM 

* 

I 

FRE (0) 
I 

I 

T 

HI MEM 



OS AND BASIC POINTERS (NO DOS PRESENT 
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Improving Program Performance 



Program performance can be improved in two ways. First the execution 
time can be decreased (it will run faster) and second, the amount of space 
required can be decreased, allowing it to use less RAM. To attain these 
two goals, the following lists can be used as guidelines. The methods of 
improvement in each list are primarily arranged in order of decreasing 
effectiveness. Therefore the method at the top of a list will have more 
impact than one on the bottom. 

Speeding Up A BASIC Program: 

1. Recode - since BASIC is not a structured language, the code 
written in it tends to be inefficient. After many revisions 
it becomes even worse. Thus, spending the time to restructure 
the code is worthwhile. 

2. Check algorithm logic - make sure that the code to execute a 
process is as efficient as possible. 

3. Put frequently called subroutines and FOR/NEXT loops at the 
start of the program - BASIC starts at the beginning of a 
program to look for a line number, so any line references near 
the end will take longer to reach. 

4. For frequently called operations within a loop use in-line code 
rather than subroutines - the program speed can be improved here 
since BASIC spends time adding and removing entries from the run 
time stack. 

5. Make the most frequently changing loop of a nested set the 
deepest - in this way the run time stack will be altered the 
fewest number of times. 

6. Simplify floating point calculations within the loop - if a 
result is obtained by multiplying a constant by a counter, time 
could be saved by changing the operation to an add of a constant 

7. Set up loops as multiple statements on one line - in this way 
the BASIC interpreter will not have to get the next line to 
continue the loop, 

8. Disable the screen display - if visual information is not 
important for a period of time, up to a 30% time savings can be 
made with a POKE 559,0. 

9. Use a faster graphics mode or a short display list - if a full 
screen display is not necessary then up to 25% time savings can 
be made. 

10. Use assembly code - time savings can be made by encoding loops 
in assembler and using the USR function. 
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Saving Space In A BASIC Program: 

1) Recode - as mentioned previously, restructuring the program will 
make it more efficient. It will also save space. 

2) Remove remarks - remarks are stored as ATASCII data and merely 
take up space in the running program. 

3) Replace a constant used three times or more with a variable - 
BASIC allocates seven bytes for a constant but only one for a 
variable reference, so six bytes can be saved each time a 
constant is replaced with a variable assigned to that constant's 
value. 

4) Initialize variables with a read statement - a data statement 
is stored in ATASCII code, one byte per character, whereas an 
assignment statement requires seven bytes for one constant. 

5) Try to convert numbers used once and twice to operations of 
predefined variables - an example is to define Z1 to equal 1 , 12 
to equal 2, and if the number 3 is required, replace it with the 
expression Z1 + 12. 

6) Set frequently used line numbers (in GOSUB and GOTO) to predefined 
variables - if the line 100 is referenced 50 times, approximately 
300 bytes can be saved by equating Z100 to 100 and referencing 
Z100. 

7) Keep the. number of variables to a minimum - each new variable 
entry requires 8 more bytes in the variable value table plus a 
few bytes for its name. 

8) Clean up the value and name tables - variable entries are not 
deleted from the value and name tables even after all references 
to them are removed from the program. To delete the entries 
LIST the program to disk or cassette, type NEW, then ENTER the 
program. 

9) Keep variable names as short as possible - each variable name is 
stored in the name table as ATASCII information. The shorter 
the names, the shorter the table. 

10) Replace text used repeatedly with strings - on screens with a 
lot of text, space can be saved by assigning a string to a 
commonly used set of characters. 

11) Initialize strings with assignment statements - an assignment of 
a string with data in quotes requires less space than a READ 
statement and a CHR$ function. 

12) Concatenate lines into multiple statements - three bytes can be 
saved each time two lines are converted into two statements on 
one line. 



7-16 



ATARI BASIC 



13) Replace once used subroutines with in-line code - the GOSUB and 
RETURN statements waste bytes if used only once. 

14) Replace numeric arrays with strings if the data values do not 
exceed 255 - numeric array entries require six bytes each, 
whereas string elements ■ only need one, 

15) Replace set color statements with POKE commands - this will save 
8 bytes, 

16) Use cursor control characters rather than POSITION statements - 
the POSITION statement requires 15 bytes for the X,Y parameters 
whereas the cursor editing characters are one byte each. 

17) Delete lines of code via program control - see the advanced 
programming techniques section. 

18) Modify the string/array pointer to load predefined data - see 
the advanced programming techniques section. 

19) Small assembly routines can be stored in remark statements - 
remarks are stored as unchanged ATASCII data. 

20) Chain programs - an example would be an initialization routine 
that is run first, and which then loads and runs the main 
program. 
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Advanced Programming Techniques 



they can also involve features of the operating system. 

Example 1 - String Initialization - This program jgj L set : all L the byt.. of 
a string o f any length |° ^ ^^Jg ^ the destination string , then the 
the S rr;ifd rl and in so on By making the destination string the second 
ITtTof rhe'source^the^ame'characLr can be stored into the entire 

string. 

Example 2 - Delete Lines Of Code - By ^'j^g^^^* 
system, a program can delete or mod, tfj , lines of ^o withi^i^ ^ ^ 
screen editor can be set to accept dota rrora cne s and 
Thus by first setting up the screen pos xtxoning the ^ ^ 
then stopping the program, BASIC will De getting 
been printed on the screen. 

. Savin, Tne ^^^^^J^u^^V 3 ^ 
SSS-^bl T^^^n^ SS„ *rin, SAVE an, 
deleting the initialization code for the next run. 

Examol- ft - Save BCD Numbers To Disk - Whenever numeric data ^ written to 
■ e device if is sent as ATASCII information. This means the numoer 
a device i- is « followed bv a 0. This makes a mess out of fixed 

written as an ATASCII 1 foliowea Dy a u. hh ± b te BC0 

se s?s--Su7^J5S5 " L i : sysrM ska - 

string. It can be retrieved in the same way. 

rv^mnTe 5 Plaver/Missile Graphics With Strings - A fast way to move 
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10 
20 
30 
40 




10 REM DELETE LINE EXAMPLE 

20 GRAPHICS 0:POSITI0N 2,4 

30 ? 70:? 80:? 90:? "CONT" 

40 POSITION 2,0 

50 POKE 842, 13: STOP 

60 POKE 842,12 

70 REM THESE LINES 

80 REM WILL EE 

90 REM DELETED 



10 REM STRING/ARRAY SAVE 
15 REM GOTO 20 FOR FIRST RUN 

17 REM DELETE LINE 20 FOR SECOND RUN 

18 GOTO 100 

20 DIM AS(10):AS="WWWWWWWWWW" 
30 STARP=PEEK(140)+PEEK(141 )*256 

40 STARP=STARP+10 

50 H I - 1 NT< STARP/256 ) : L0=STARP-H I *256 
60 POKE 140,LO:POKE 141, HI 
70 SAVE "D: STRING": STOP 
1 00 STARP-PEEK ( 1 40 5+PEEK (141) *256 
110 STARP = STARP— 1 0 

1 20 H I »l NT ( STARP/ 256 ) : L0=STARP-H I *256 
130 POKE 140,L0:P0KE 142,L0:P0KE 144, LO 
140 POKE 141,H!:P0KE 143,HI:PCKE 145, HI 
150 DIM AS (10) 
160 AS(10,10)="W" 
170 STOP 
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10 REM SAVE AND RETRIEVE BCD NUMBERS ON DISK 

15 DIM A(0),B$(6) 

20 B$(6,6)=CHRS(32) , = ^ oc , 

30 VTAB=PEEKC134)+?EEKC135)*256 

40 POKE VTAB+10,0 

50 OPEN #1,8,0,"D:TEST" 

60 FOR C=1 TO 15:A(0)=C:? #1;AS:NEXT C 

70 CLOSE #1 

|°o SST^'fe'iSlKTn^i *<o>:hext c 

100 CLOSE #1:END 



100 REM PLAYER/MISSILE EXAMPLE 

Un X-X^READ^Hf'ao-I THEN BSCX,X)=CHRS(A) :G0T0 120 
lf 0 X DATA 1 o!f5ll^129,129,129J 29,129,l29,129,25,,0,.1 

2000 POKE 559, 62: POKE 704,38 

2020 |-PEEK(106)-16:POKE 54279,1 

2030 POKE 53277,3:POKE 710,224 

2040 VTAB=PEEK(134)+PEEK(135 *256 

2050 ATAB=PEEK(140)+PEEK(141 )*256 

2060 0FFS=I*256+1024-ATAB 

2070 H I = I NTCOFFS/ 256 ) : L0=0FFS-H I *256 

2090 POKE VTAB+2,L0:P0KE VTAB+^,HI 

3000 Y=60:Z=100:V=1 :H»1 

4000 AS(Y,Y+11)=BS:PCKE 53248,Z 

4010 Y=Y+V:Z=Z+H 

4020 IF Y>213 OR Y<33 THEN V=-V 

4030 IF Z>206 OR Z<49 THEN H— H 

4420 GOTO 4000 
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CHAPTER 8 
OPERATING SYSTEM 



INTRODUCTION TO THE 
OPERATING SYSTEM 



This section Is a simple Introduction to the Operating System (O.S.) of 
the ATARI 400/800. This section also contains a brief description of the 
elements of the O.S. The following sections will describe these elements In 
detal I : 

Input/Output Subsystem 
ROM-Based Character Set 
System Routine's Vectors 
Interrupt Handlers 
Mon i tor 

System Database 

System and Event Timers 

Floating Point Package 



The O.S. allows the application programmer access to the full 
capabilities of the computer's hardware. The ATARI Personal Computer 
System's hardware Is capable of providing you with some excellent I/O 
functions via the I/O subsystem. The I/O subsystem Is a set of system 
routines that Interface with the I/O hardware. The rest of the O.S. supports 
the I/O subsystem and provides you with additional features you can use for 
app I feat ions . 

The ROM-based character set Is used by the display handlers to write 
characters on the television screen. If you wish, you can create your own 
character set and tell the O.S. to use it Instead. 

■ 

The system vectors provide the glue that holds the O.S. together. The 
O.S. uses the vectors to move from one execution environment (BASIC, DUP, 
Star Raiders") to another. You can call any system routine by jumping to Its 
vector. The vectors are most frequently used to call I/O system routines, 
set timers and transfer control to different execution environments. 

The system routines may be vectored In one of two ways. The ROM vectors 
are locations that contain JMP Instructions to system routines and cannot be 
altered. The RAM vectors are locations that contain alterable addresses of 
system routines. The locations of both types of vectors are guaranteed to 
remain the same In future releases of the O.S. 

The computer generates Interrupts for several different reasons. Some 
of the most common Interrupts are keyboard, <BREAK>, serial bus, and vertical 
b 1 ank . 
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The O.S. *omtor I. a system routine to 1. j tie I lj» the 
comp I ete . 

The 0.3. I. supported Py . ""'E^of ^JSbSfS 

flegs, I/O buffers , end screen/g reph "« regis te r s. ^ost o , usel! by 

timers. Hardware timers are used to t me real Time 
television scan lines in a screen display. 

The floating point pacKage is a set of ^^1^ routing.. 
+o the user. The routines use binary coded decimal C BCD > ' T VVTl » / i as 

ZZrJTZl Provided to do the ~^"?:'aT«Su "roi^ A" 
well as conversion from ATASCI I to SCU ana duu to n Section 

the package. 



8-2 



OPERATING SYSTEM 



[THIS PAGE INTENTIONALLY LEFT BLANK] 




8-3 



OPERATING SYSTEM 
I/O SUBSYSTEM STRUCTURE 



.LL PERIPHERAIS 
iXCEPT RESIDENT 
ISK HANDLER 



I 



CIO CALL: 




JSR CIOV 
BMI ERROR 
BPL SUCCESS 



CENTRAL 
I/O ROUTINE 

(CIO) 



CALL TO DEVICE 
HANDLER: 



USE HANDLER ADDRESS 
TABLE (HATABS) TO 
FIND THE DEVICE 
HANDLER ENTRY POINT 




RESIDENT 
DISK HANDLER 




SER PROGRAM 

(DOS or 
ASSEMBLER) 



SERIAL BUS 
PERIPHERALS ONLY 



DISK HANDLER CALL 
JSR DSKIOV 

BMI ERROR 

BPL SUUCESS 
j 

32 



SERIAL 
I/O ROUTINE 
(SIO) 



RES IDENT 
DISK HANDLER 



SERIAL DATA 
TRANSFER VIA 

SERIAL BUS 



FIGURE ?.l I/O SUBSYSTEM 



OPERATING SYSTEM 
SECTION 8.2 - - I/O SUBSYSTEM 



INTRODUCTION 

The I/O subsystem provides a convenient method of accessing the I/O 
hardware registers used by ANTIC, POKEY, CT1A and PI A. These special purpose 
chips control the I/O devices such as the keyboard, printer and disk. You 
simply pass control data to the I/O subsystem and It will perform the 
requested I/O function for that device. 

The I/O subsystem has two types of elements: I/O system routines and 
I/O system control blocks. The I/O system routines are the central I/O 
routine (CIO), the device handlers (I.e. E: , P:, Ks) and the serial I/O 
routine (SIO). The system I/O control blocks contain control data that is 
routed to the I/O subsystem. The user interface appears the same for all 
devices (e.g. the commands to output a line to the printer (P:) or to the 
display editor (E:) are very similar). 

You need to understand the structure of the I/O subsystem to get the 
most out of It, Figure 8.1 shows the relationship of the I/O system 
routines and the I/O system control blocks. 

I/O SYSTEM CONTROL BLOCKS 
There are three types of control blocks: 



Input/Output Control Block (IOCS) 
Zero-Page I/O Control Block (Z10CS) 
Device Control Block (DCS) 

The I/O system control blocks are used to communicate information about the 
I/O function to be executed. The control blocks provide the I/O system 
routines with control Information to perform the I/O function. The O.S. 
Manual has Information as to the detailed structure of the three types of 
control blocks In Section 5. 



FUNCTION 


NAME 


I Serial Bus I.D. 


1 DOFVIC 


| Device Number 


1 OUNIT 


| Command 3yte 


| OCOMNO 


I Status 


| 0STAT5 


1 Buffer Address 


\ 06UFLQ 




I oveuFHi 


| Device Timeout 


1 OTIMLO 


I Buffer Lenctn 


I OBYTLO 




| DBYTHI 




1 DAUX1 




I 0AUX2 



LOCATION 

[$0300] 
[$0301] 
[$0302] 
[$0303] 
[$0304] 
[$0305] 
[$0306] 
[$0308] 
[$0309] 
[$03CA] 
[$03C8] 



i am 
° 1 u 




1 >>u 


l $30 


1 




i 1-4 


I i-a 


! 




I $52 


I $52 


I 




I $40 


I $40 


! 

I U 


! U 


I 

i u 


I u 


l 




i $30 


I $30 


I 




I $80 


I 00 


I 




l $00 


! 01 


I 






i 2* 


I 


I 


! 


I 2* 



81 



| $30 I $30 l S30 

I t-4 I 1-a l t-* 

I I I 

| 557 I $57 ! $50 



i 



| $80 I $80 I $30 



I 

I U 
I 

I u 

i 



t 

l u 
i 

! U 
I 



I 

i U 



i u 



I $30 I $30 



$31 



I 



\ $80 I 00 I $80/00 



| $00 I 01 i $00/01 

I i I 



r 0ftMA - 

$30 
1-4 

$21 

$40 

u 
u 

$130 
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1* s Thil oyte determines orinter «ode (gi ^ZMU or *RITE verify. 
Z- s OAUX1 - 0AUX2 specify sector for READ, wait ^ru 
U s Indicates user-set address 
- x indicates ignored. 



PRINTER j 
| WRITE 



I $40 



I $57 

I 

I $80 

I 

I U 
I 

I u 

I 

I 5 
1 

1 $40 

! 

1 $00 



OPEN FILE-*RITE 



1 CALL 

| OPEN FILE-READ 

1 
I 
t 

I GET BYTES 

I 

| PUT BYTES 

I 

1 GET RECORD 

I 

| PUT RECORD 

I 

I CLOSE FILE 

I 

| STATUS 

I 



ICC3 CHART 

I T raiP \ IC3N0 ! ICCOH I I CSTA j IC3AL 

I 

1 x 

I 

i x 

i 

i x 

I 

I x 

I 

I x 

I 

! X 
x 

! x 

I 



IC3AH 



1 


X 


1 3 


1 




1 


1 


X 


i 3 


1 




1 


1 


X 


1 7 


I 




1 


I 


X 


I $8 


1 




1 


1 


X 


1 5 


I 




i 


I 


X 


1 9 


I 




i 


\ 


X 


1 $c 


\ 




1 


\ 


X 


I SO 





11 $80 


1 06 




I 


1 


n 


I $80 


1 06 




I 


1 


M 


1 00 


I 06 




I 


1 


* 


1 00 


1 06 

i 




1 

1 00 


I 06 




I 


! 


n 


\ 00 


1 06 




1 


1 


•t 


i x 


i x 




I 


1 


n 


1 x 


I x 




! 
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1 
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IC3LL 


1 IC3LH 
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X 


1 x 


1 
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X 


1 x 
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1 


i 


$80 


i 00 


t 




1 


i 
i 


$80 


I 00 




1 


i 


$80 


1 00 


i 




1 


i 


$80 


1 00 


i 




1 


i 


X 


I x 


i 




! 


I 


X 


I x 


i 




1 



ICAX1 1 ICAX2 



^ meui in the Y REG. on return from CIO. 
NOTE 1 * The status of th. I/O ^"uss^y SbEwdiW- " inoict. .p.ci.1 WM. 



CE^NuTl; The aoove I0C3 definitions assume: 

IOSUFF .RES BO 

FILE .BYTE '0:MYPROG.BAS 



4 
8 

X 

X 

X 

X 

X 



0 

note 2! 

X 
X 
X 

X 

X 

X 



USER I/O BUFFER 
USER FILENAK1 
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The eight lOCSs In the O.S. are used for communication between user 
programs and CIO. Figure 8.2 shews the content of an I0C8 for some common 
I/O functions. The IOCS f s are: 



The second type of control block, the ZI0C3 [$0020,16], Is used to 
communicate I/O control data between CIO and the device handlers. When 
called, CIO uses the value contained In the X register as an Index that 
points to the starting address of the IOCS (one of 8) to be used. CIO then 
moves the control data from the selected IOCS to the Z10C8 for use by the 
appropriate device handler. The ZI0C3 Is of little Interest unless you are 
writing a new device handler or are replacing a current one. See section 9 
of the O.S. User Manual for more Information on the ZI0C3. 

The device handlers load control Information into the DCS [$0300,16]. 
SIO will use the DCS Information and return the status Information In the DCS 
for subsequent use by the device handler. Only device handlers that use the 
serial bus use the DC8 and SIO. Section 9 of the O.S. User Manual contains a 
detailed description of the DCS. Figure 8.3 Illustrates some common I/O 
functions and the contents of their associated DCBs. 

The resident disk handler does not conform to the regular user-ClO- 
handlei — SIO calling sequence. Instead, you use the DC3 to communicate 
directly with the resident disk handler. Chapter 9 of this bock contains 
more information on the resident disk handler. 



Name 



Location, 
Length 



I0CB0 
I0C81 
I0CB2 
10CS3 
I0CB4 
I0CS4 
I0CS5 
I0CS6 
I0C87 



[$340,16] 
[$350,16] 
[$360,16] 
[$370,161 
[$380,161 
[5390,161 
[S3A0,16l 
[$3B0,16l 
[$3C0,16] 
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CENTRAL I/O SYSTEM ROUTINE - CIO 

CO, main function Is to route Jg.^^* •£ ^ aTcmTn'exIt 
handler and then pass control ^^^^tS* is the common entry point for 
routine for all of the dev ce handlers. C O is t ^ 

^Wfe'^^^r f ° ,,0W,n9 fUnC+,0nS: 

nptrw Devi ce/ file open 

CLOSE Device/file close 

C-ET CHARS Read 1-N characters 

READ RECORD Read next record 

PUT CHARS Write 1-N characters 

WRITE RECORD Write next record 

STATUS Get devl ce st arus s) 

SPECIAL Device handler specific te.g. 

- pin rails The calling sequence for CIO is: 
wish to make your own CIO calls. 

;rem user has set up IOCS 

iS ERROR tf" £J ™ 

•error code In Y regiSTer 

4. K - inp^e; is used to ccmmun I cate 
As shown in the above call, one of t he IOCS s Is use ^ 

control data to CIO. You may use any O^^Tt h * £ atus bI+s of the 6502 
IOCS index to be In the X register. On return, T |f the N bit is 

ire set to Indicate success or error in the I/O oper , contaIn a 

Tear (S'OM the I/O was done ^«£^£ZZ£in an error; the Y 

READ some records, and CLOSE the file. 



Ycu may 



CO routes 1/0 ccntro, 9 at,by -I* c !ST h « e^«^'^ " 

^ove the contents of the your '.M+L™ ^appropriate oevice handler 
Sr-.rW^i'?" "-^^he Cio'syste. routine. 



CIO oa,ou,ates the ^'-^^^Bi&l-^Wu^ 

During an OPEN '^0^0. « .1^ « ^ rts "•""*«• Th * 

ppcxjpd Let us assume tnar Tne aeviw© 
de^ice'specification for the printer would be »P. . 
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01 ; HANDLER ADDRESS TABLE 



E430 




02 PRINTV 




SE430 




E440 




03 CASETV 




SE440 




E400 




m tmmm^. • a a 

04 ED I TRY 




SE400 




E410 




05 SCRENV 




SE410 




E420 




06 KEYBDV 

07 ; 




SE420 




0000 




08 


*« S031A 








09 ; 












10 HATABS 








031 A 


50 


20 


.BYTE 


tot 


PR I NTER 


031B 


30E4 


30 


• nUKU 


DO J KJTV 
r K i IN 1 Y 


ENTRY POINT TAdLd 


03 1D 


43 


40 


DYTD 


IP! 


CAooc i i c 


a mm + mm 

03 1E 


40E4 


50 


u/npn 

• ffwrvU 


pa cpTV 


rviTDV DA? KIT TAD! D 

cNlKT rUI IN I 1 noLfc 


0320 


45 


60 


RYTP 
• OTIC 


* p ' 


n ! coi a v cn i tad 
U i brLAT cU 1 1 UK 


0321 


00E4 


70 


WORD 


FD ITRV 


CKJTDV DO 1 KIT TAR! P 
C.NIKT rut IN 1 1 aDLI 


0323 


53 


Q A 

OU 


RYTP 
• OTIC 


1 c t 


cpDCDXJ WAWHI PP 


0324 


10E4 


90 




^PPPXIV 


CVJTDY POIMT TAR1 P 
CiNlKT rUINl IaOLl, 


0326 


4B 


01 00 


.BYTE 


»K' 




0327 


20E4 


A 1 1 A 

0110 


.WORD 


KEYBDV 


PXITDY DOIMT TAR! P 
CiNlKT rVJliNI 1 aDLl 


0329 


00 


A 1 OA 

01 20 


.BYTE 


0 




03 2A 


00 00 


01 30 


.BYTE 


0,0 




032C 


A A 

00 


a 1 /in 

01 40 


.BYTE 


0 


rpcp PWTRY 5 (850 MODULE) 


032D 


00 00 


01 50 


.BYTE 


0,0 




032F 


00 


0160 


.BYTE 


0 


CDCD DM TOY X 


0330 


00 00 


0170 


• BYTE 


0,0 




0332 


00 


0180 


.BYTE 


0 


FREE ENTRY 4 


0333 


00 00 


0190 


.BYTE 


0,0 




0335 


00 


0200 


.BYTE 


0 


FREE ENTRY 5 


0336 


00 00 


0210 


.BYTE 


0,0 




0338 


00 


0220 


.BYTE 


0 


FREE ENTRY 6 


0339 


00 00 


0230 


.BYTE 


0,0 




033B 


00 


0240 


.BYTE 


0 


FREE ENTRY 7 



FIGURE 8.4A HANDLER ADDRESS TABLE (HATABS) 







*«; 


SPR 1 NTV 




E430 


9E 


EE 


.WORD 


PHCPEN-1 


E432 DB 


EE 


.WORD 


PHCL0S-1 


E434 


9D 


EE 


.WORD 


BADST-1 


E436 


A6 


EE 


• WORD 


PHWRIT-1 


E438 


80 


EE 


. WORD 


PHSTAT-1 


E43A 


9D 


EE 


.WORD 


BADST-1 


E43C 


4C 


78 


EE JMP 


PHINIT 



DEVICE OPEN 
DEY1CE CLOSE 

DEVICE READ-NOT IMPLEMENTED 

DEVICE WRITE 

DEVICE STATUS 

SPECIAL -NOT IMPLEMENTED 

DEVICE INITIALIZATION 



FIGURE 8.48 PRINTER HANDLER ENTRY POINT TABLE 
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CIO uses a table called HATABS (figure 8.4A) to Indirectly calculate the 
handler entry point. This table uses a device specification as a key to find 
the address of the associated handler entry points. The device specification 
is used to find the HATABS entry for the device we want to OPEN. CIO starts 
at the end of HATABS and looks for the first entry that matches the current 
device specification (In our case 'P:», the first entry in the HATABS). The 
address associated with the device spec Is a pointer to a list of handler 
entry points (the handler entry points for the printer are shown In figure 

8. 48). 

CIO uses ICCOM, the IOCS command byte, to find which one of the handler 
entry points to vector thru. The entry point tables for all of the resident 
device handlers can be found in the O.S. listing. The positions in all The. 
device handler entry point tables have the same meaning. For example, the 
first position in all of the device handler entry point tables Is the vector 
to the device handler OPEN routine. 

HATABS Is located In RAM at S031A and It contains room for 14 entries. 
At power-up and SYSTEM RESET the contents of HATABS is initialized as shown 
in figure 8.4. HATABS at this time has entries for all the resident handlers 
except the disk handler. The disk handler ts never called via HATABS (see 
Chapter 9) . 

Other entries may be added to HATABS by you or by the O.S. The O.S. may 
add entries as part of Its power-up or SYSTEM RESET function. Any new 
entries would start at 50329. Additions to HATABS might be entries for the 
disk drive (the File Manager or FMS) or the 850 module. 

You can take advantage of the flexible nature of HATABS to add seme new 
features to the O.S. One example (figure 8.5) shews how to add a null 
handler. A null handler is exactly what It sounds like, It performs NO 
FUNCTION! A null handler may be used to debug programs that use devices that 
have slow access speed. Instead of waiting for 50,000 disk accesses to find 
a bug, just run the output thru the null handier! 

Another use of HATABS is to change the function of an old entry in 
HATAES. Suppose you wanted to add a printer to your computer that had some 
special features not supported by the current printer handler. By changing 
the HATABS entry point table pointer, you can point all 'Pi' I/O to your own 
printer handler. Aopendix VI I gives an example of a Qume prtnrer handler 
that uses the front' control I er ports for speedy transfer of data to be 
printed. 
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0000 




10 


*« $600 




031A 




20 HATABS 


S031A 








30 START 




• 




0600 


A000 


40 

50 LOOP 


LDY 


#0 




0602 


B91A03 


60 


LDA 


HATABS, Y 




0605 


C900 


70 


CMP 


#0 


FREE ENTRY? 


0607 


F009 


80 


BEQ 


FOUND 




0609 


C8 


90 


1 NY 






060A 


C8 


0100 


1 NY 






060B 


C8 


01 10 


1 NY 




POINT TO NEXT HATABS ENTRY 


060C 


C022 


0120 


CPY 


#34 


AT END OF HATABS? 


060E 


D0F2 


0130 


BNE 


— — mam. 

LOOP . 


NO ... 


0610 


33 


0140 


SEC 




YES, FLAG ERROR TO CALLER 


061 1 


60 


0150 
0160 j 
0170 FOUND 


RTS 






0612 


•A94E 


0180 


LDA 


# T N 


DEVICE NAME 


0614 


991A03 


0190 


STA 


HATABS,Y 




061 / 


C8 


0200 


1 NY 






0618 


A924 


0210 


LDA 


#NULLTAB&25:> 




061A 


991 A03 


0220 


STA 


HATABS , Y 


NULL HANDLER ENTRY TABLE 


061D 


C8 


0230 


1 NY 


■ 




061 E 


A906 


0240 


LDA 


#NULLTAB/256 




0620 


991A03 


0250 


STA 


HATABS , Y 




0623 


60 


0260 
0270 ; 


RTS 










0280 NULLTAB 






0624 


3206 


0290 


.WORD 


RTHAND- 1 


OPEN 


0626 


3206 


0300 


.WORD 


RTHAND- 1 


CLOSE 


0628 


3406 


0310 


.WORD 


NOFUNC- 1 


READ 


062* 


3206 


0320 


.WORD 


RTHAND-1 


WRITE 


062C 


3206 


0330 


.WORD 


RTHAND- 1 


STATUS 


062E 


3406 


0340 


.WORD 


NOFUNC- 1 


SPECIAL 


0630 


4C3306 


0350 
0360 ; 
0370 RTHAND 


JMP 


RTHAND 


INITIALIZATION 


0633 


A001 


0380 

0390 NOFUNC 


LDY 


#1 


SUCCESSFUL I/O FUNCTION 
FUNCTION NOT IMPLEMENTED 


0635 


60 


0400 


RTS 







FIGURE 8.5 NULL HANDLER 
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DOING CIO FROM BASIC 



Most of the CIO functions (OPEN, CLOSE, etc.) are available through 
calls from BASIC. BASIC lacks one set of the functions of CIO, the ability 
to do non-record I/O more than a byte at a time (GETCHRS and PUTCHRS). 

The ability to Input or output a buffer of characters at a time Is a 
nifty feature. For Instance, an assembly language routine can be loaded 
directly Into memory from a disk file. In a BASIC program, an assembly 
language routine is normally read Into a string and a USR call Is made to 
ADR(string). Since the address of a BASIC string may shift during program 
modification, the assembly language routine must be location Independent. 
This means memory reference Instructions to addresses within the string will 
not work . 

The subroutine In figure 8.6 avoids the use of strings. This way the 
assembly module does not have to be location independent. Control data is 
POKEd into an IOCS to read an assembly language routine directly Into RAM at 
the address It was assembled. The BASIC subroutine in figure 8.6 can also be 
used to output data directly from memory with the user specifing both the 
location and the length of the data buffer. 



The device handlers can be divided into the resident and non-resident 
handlers. The resident handlers are present in the O.S. ROM. Any resident 
handlers can be called through CIO as long as the handler has an entry In 
HATABS. The resident device handlers are: 



THE DEVICE HANDLERS 



(E:) 
(S:) 
(K: ) 
(P:) 
(C;) 



DISPLAY EDITOR 

SCREEN 

KEYBOARD 

PRINTER 

CASSETTE 
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30 REM THIS PROGRAM LOADS PAGE 6 FROM THE FILE D:TEST 

100 DIM FILES(20),CI0$(7):CI0$= ,, hhh*LVd n ( Indicates Inverse video) 

106 REM CIOS IS PLA,PLA,PLA,TAX,JMP SE456 (CIOV) 

110 F1LE$="D: TEST": REM _ *FILE NAME 

120 CMD=7:STADR* 1536: GOSUB 30000 

130 IF ERROR <>1 THEN ? "ERROR - n ; ERROR ; " AT LINE "; 
135 ? PEEK(186)+PEEK(187)*256,PEEK(195) 
200 END 

300 REM _ CIO SETUP SUBROUTINE 

310 REM 

30000 REM ROUTINE BY M. EKBERG FOR ATARI 9-3-80 

30001 REM 

30002 REM THIS ROUTINE LOADS OR SAVES MEMORY FILE FROM BASIC 

30003 REM BY SETTING UP AN IOCS AND CALLING CIO DIRECTLY 

30004 REM 

30006 REM ON ENTRY CMD=7 MEANS LOAD MEMORY 

30008 REM _ CMD=11 MEANS SAVE MEMORY 

30009 REM _ STADR= THE ADDRESS TO LOAD OR SAVE MEMORY 

30010 REM _ BYTES- THE NUMBER OF BYTES TO SAVE OR LOAD 

30011 REM _ IOCS= THE IOCS TO USE 

30012 REM _ FILES- DESTINATION FILE NAME 

30013 REM _ 

30014 REM ON EXIT ERROR= 1 MEANS SUCCESSFUL COMMAND 

30018 REM _ ERROR <>1 THEN ITS AN ERROR STATUS 

30019 REM 

30020 REM _ *** IOCS EQUATES *** 
30022 REM 

30024 I OCSX= I OCS* 16:1 CCCM=834+ I OCSX : I CSTA=835+ I CCSX 
30026 IC3AL=836+I0CBX: I CBAH=837+ I OCSX 

30028 ICBLL=840+IOC8X: ICBLH=841+I0CSX 

30029 REM 

30030 AUX1=4:!F CMD=11 THEN AUX1=8 

30035 TRAP 30900: OPEN #I0CS,AUX1 ,0, FILES: I OCSX= I OCS* 1 6 

3004U TEMP=STADR : GOSUB 30500 

30090 POKE IC3AL,L0W:POKE IC3AH,HIGH 

30100 TEMP=BYTES : GOSUB 30500 

30130 POKE ICBLL,LOW:POKE ICBLH,H IGH 

30140 POKE ICCOM,CMD:ERROR=USR(ADR(CICS) , I0C3X) 

30 1 50 ERRCR=PEEK ( I CSAT) : RETURN 

30200 REM 

30300 REM _ ***R0UT1NE RETURNS HIGH, LOW BYTE OF 16 BIT NUMBER 
30400 REM 

30500 H I GH= I NT( TEMP/256 ) : LOW= ! NT ( TEMP- H I GH*256 ) : RETURN 
30550 REM 

30600 REM ***TRAP HERE IF ERROR IN ROUTINE**** 
30900 ERR0R-PEEKU95) 
30920 CLOSE § I OCS : RETURN 



FIGURE 8.6 BASIC DIRECT CIO CALL 
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The non-resident handlers are not present In the O.S. ROM. Non-resident 
handlers may be added by the O.S. during power-up or SYSTEM RESET, or you can 
add your own device handler during program execution. Refer to figure 8.5 as 
an example of adding a handler to* the O.S. 

The device handlers use I/O control data passed by CIO In the ZIOCS. 
The data In the ZIOCS Is used to perform I/O functions such as OPEN, CLOSE, 
PUT, and GET. Not all of the device handlers support all the 1/0 commands 
(e.g. trying to PUT a character to the keyboard results In an Error 146, 
Function Not Implemented). Section 5 of the O.S. Manual contains a list of 
the functions supported by each device handler. 



SERIAL I/O SYSTEM ROUTINE - - SIO 



SIO AND THE DEVICE HANDLERS 

SIO handles serial bus communication between the serial device handlers 
in the computer and the serial bus devices. SIO communicates to Its caller 
through the device control block (DCB) . SIO uses the I/O control data In the 
DCS to send and receive commands and data over the serial bus. The calling 
sequence Is: 

;caller has set up the DCB to do function 
JSR SIOV ; system vector to SIO 

BMI ERROR ;N bit set indicates error In I/O execution 

The DCB contains I/O control Information for SIO and must be setup 
before the call to SIO. Figure 8.3 shows the contents of the DCB for some 
common I/O operations. 

You need to understand the structure of the DCB to send commands to SIO. 
The DCB Is described In section 9 of the O.S. Manual. Figure 8.7 
demonstrates a simple assembly language routine to output a line to the 
printer by setting up the DCS and calling SIO. 
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0000 




05 


*= $3000 ARBITRARY START 




10 ;THI S ROUTINE PRINTS A LINE TO THE PRINTER BY CALLING S 


E459 




20 SIOV 




SE459 


SIO VECTOR 


009B 




30 CR 


m 


$9B 


EOL 


0040 




40 PRNTID 


s 


$40 


PRINTER SERIAL BUS ID 


004E 




45 MODE 


m 


$4E 


NORMAL MODE 


001C 




50 PTIMOT 


m 


S001C 


TIMEOUT LOCATl ON 


0300 




60 DDEVIC 


3 


S300 


DEVICE SERIAL BUS ID 


0301 




70 DUN IT 


8 


$301 


SERIAL UNIT NUMBER ■ 


0302 




80 DCOMND 




$302 


SIO COMMAND 


0303 




90 DSTATS 




$303 


SIO DATA DIRECTION 


0304 




0100 DBUFLO 


■ 


$304 


BUFFER LOW ADDRESS 


0305 




0110 DBUFHI 


s 


$305 


BUFFER HIGH ADDRESS 


0306 




0120 DTIMLO- 


m 


$306 


SIO TIMEOUT 


0307 




0130 DTI MH 1 


m 


$307 




0308 




0140 DBYTLO 


m 


$308 


BUFFER LENGTH 


0309 




0150 DBYTHI 


s 


$309 


AUXILARY BYTE PRINTER MODE 


030A 




0160 DAUX1 




$30A 


030B 




0170 DAUX2 




$30B 


AUXILARY BYTE NOT USED 






0180 ; 








3000 


455841 


0190 MESS 


.BYTE 


"EXAMPLE 12 n ,CR 


3001 


4D504C 










3005 


452031 










3009 


329B 














0200 ; 








300B 


A940 


0220 


LDA 


#PRMTI D 


SET BUS ID 


300D 


800003 


0230 


STA 


DDEVIC 




3010 


A901 


0240 


LDA 


#1 


SET UNIT NUMBER 


3012 


800103 


0250 


STA 


DUN1T 




3015 


A94E 


C260 


LDA 


JMODE 




3017 


8D0A03 


0270 


STA 


DAUX1 


PRINTER MODE NORMAL 


301 A 


A901 


0275 


LDA 


#1 




301C 


80 OB 03 


0280 


STA 


DAUX2 


UNUSED 


301 F 


800703 


0290 


STA 


DTIMHI 


TIMEOUT<256 SECS 


3022 


A51C 


0300 


LDA 


PTIMOT 


SET SIO TIMEOUT FOR PRINTER 


3024 


8D0603 


0310 


STA 


DTI MLO 




3027 


A900 


0320 


LDA 


#MESS£255 


3029 


8D0403 


0330 


STA 


DBUFLO 


SET MESS AS BUFFER 


302C 


A930 


0340 


LDA 


#MESS/256 


302E 


8D0503 


0330 


STA 


DBUFH I 


SET SIO DATA DIRECTION FOR 


3031 


A980 


0360 


LDA 


#$80 


3033 


8D0303 


0370 


STA 


DSTATS 


PERIPHERAL TO RECEIVE 


3036 


A957 


0380 


LDA 


/ ' W 


SIO COMMAND WRITE 


3038 


80 0203 


0390 


STA 


DCOMND 




303B 


2059E4 


0410 


JSR 


SIOV 


CALL SIO 


303E 


3001 


0420 


BMI 


ERROR 




3040 


00 


0430 GOOD 


BRK 






3041 


CO 


0440 ERROR 


BRK 










F I GURE 


8.7 SIO 


CALL TO 


DUMP LINE TO PRINTER 
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SIO INTERRUPTS 



S,0 oses three IRQ Interrupts to send -Receive ser,a. bus 
connunlcations to serial bus devices. They are. 



IRQ 



Location, 

Length Function 



ucfrir TS020A.21 SERIAL INPUT READY 
IISoR CS020C 23 SERIAL OUTPUT NEEDED 
VsioC feffia TRANSMISSION FINISHED 



A11 program execution Ij^l^^^^r^^^^^ 
communication. For output SIO gives the POKEY serial o ^ , 

(SEROUT) a byte to send on the serial bus, then T en fop 
it receives an IRQ (VSEROR) f P0 ?Lj t ?il Sb routine to load SEROUT with 
-ther byte The louses iVVXt* specified In the DCS 
SSSTlJSS lave e°en sen? VSEROR Is an IRQ indicating that the 
SSSllSS of the byte over the bus is complere. 

The SIO execution for fnp ut t. • $ ^f^^ ^° n eratllg ».RQ 

been received in the serial Input f '^egi ^er <>E R Y 9 ^ ^ ^ 
(VSERIR). SIO stores the byte In a buffer and the 



next " IRQ te Ms 1 1 inot^iWhas been received. 



You ma y have noticed from the above exp, ^J^SiSTSl'S 
time idling while «' + In 9 * or ^^f S TS !S soviet routines are RAM vectors, 
^ /an STuSTy — JS^^EvT^ P— 

lnd eed. this ,s how the 85C ) mod; ,,. Is able to do ^rrentJ/O^. The 
850 module handler takes over The SIO I RQ v ecro r s a J |/Q> The 850 

vectors to the module's own IRQ routines while wh ,, e waiting for the 

Module handler can then send commands over the bus. ^ execu+ing 

850 Module to do the command, the 850 Mcauie 
program to continue. 
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SECTION 8.3 - - INTERRUPTS 



INTRODUCTION 

* 

In the previous section we have seen how SIO uses Interrupts to 
coordinate transfer of data over the serial bus. The computer also has other 
catagorles of Interrupts. You can use several of these other Interrupts to 
add some powerful features to your application. It should be noted that 
there are two types of Interrupts, the maskable (IRQ) and the non-maskable 
(NMI) Interrupts. The PCS Interrupts are: 



Name (vector) Type 


Function 


Used By 


DISPLAY LIST (VDSLST) . 


NMI 


Graphics timing 


User 


SYSTEM RESET (none) 


NMI 


System In It. 


PCS 


VERTICAL BLANK ( VVBLK 1 , VVBLKD) 


NM! 


Graphics display 


PCS, user 


SERIAL OUTPUT READY (VSERIN) 


IRQ 


Serial Input 


PCS 


SERIAL INPUT READY (VSEROR) 


IRQ 


Serial Input 


PCS 


SERIAL OUTPUT COMPLETE (VSEROC) 


IRQ 


Serial output 


PCS 


FOKEY TIMER 1 (VT1MR1) 


IRQ 


Hardware timer 


User 


POKEY TIMER 2 (VTIMR2) 


IRQ 


Hardware timer 


User 


*POKEY TIMER 4 (VT1MR4) 


IRQ 


Hardware timer 


User 


KEYBOARD (VKEYBD) 


IRQ 


Key hit 


PCS 


BREAK KEY (none) 


IRQ 


<8REAK> hit 


PCS 


SERIAL BUS PROCEED (VPRCED) 


IRQ 


Device proceed 


Unused 


SERIAL BUS INTERRUPT (VINTER) 


IRQ 


Device Interrupt 


Unused 


* This IRQ is not vectored In 


the 


current O.S. 





If you are not familiar with Interrupts, Section 6 of the O.S. Manual 
contains Information on them. Working with Interrupts can be tricky. For 
example, If you accidentally disable the keyboard IRQ Interrupt, the computer 
will Ignore ail the keys except the <SR£AK> key. Although this may be useful 
sometimes, It may make debugging your program a bit difficult! 



THE IRQ INTERRUPT HANDLER 

The O.S. has an IRQ Interrupt handler that processes the various IRQs. 
The IRQ Handler has RAW vectors for all of the IRQs except the <8REAK> key 
IRQ. The IRQ vectors are set to their Initial values during both power-up 
and SYSTEM RESET. The locations of the IRQ RAM vectors are described in 
figure 8.9B. 
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The IRQs vectors are: 

VIMIRQ — Immediate IRQ vector. At I IRQ«S vector 

Interrupt processing. 

VSEROR - Pokey Serial Output Ready IRQ vector, (see 
section 8.2) 

VSERIN - Pokey Serial Input Ready IRQ vector, (see 
section 8.2) 

YSERCC - Pokey Serial Output Complete IRQ vector, 
(see section 8.2) 

VT1MR1 - Pokey Timer 1 IRQ vector, (see section 8.7 
for information on the Pokey Timers) 

YJ1MR2 — Pokey Timer 2 IRQ vector. 

VT1MR4 — Pokey Timer 4 IRQ vector. 

VKPYED — Keyboard IRQ vector. Pressing any key 
I Sp«k> causes this IRQ. VKEYEO can.be used to 

O.S. keyboard IRQ routine. 

SSTriili "«J irSiSi VTpS^t and no™ My po>nts 
to an RTl . 

V I NTER - Peripheral interrupt IRQ vector. The 
tn+er V r ^,„ e ,s a?so -liable on the serial bus. 
V I NTER also normally points to an kii. 

VBREAK - 6502 3RK Instruction IRQ vector. Whenever 
a S00 opcode (the software break Instruct £>^» +c 
executed, this Interrupt occurs. VBREAK canj* usefl 
set break points for a debugger. VBREAK normally po. 
to an RTI . 
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The IRQs are enabled and disabled as a group by the 6502 Instructions 
CLI and SE! respectively- The IRQs also have Individual enab I e/d t sab I e bits. 

Section III of the hardware manual shows the IRQs and their enable/disable 
b I ts . 

Register (IRQEN) contains most of the IRQ enable/disable bits and Is a 
write-only reclster. The O.S. keeps a shadow of IRQEN for you to read In 
POKMSK. POKMSK Is written to IRQEN during vertical blank. 



USING THE IRQS 



Many applications require that the keyboard be ' Id lot-proofed ' . This 
means a user can press any key or combination of keys and the program will 
accept valid key sequences and ignore invalid ones. You can use a couple of 
the IRQ vectors to ' id lot-proof ' your program. The example in figure 8.3 
uses the VKEYBD IRQ vector to disable the control key. The routine also 
masks the <BREAK> key by stealing the VIMIRQ vector and ignoring the <8REAK> 
key interrupt. 

THE NMI HANDLER 

The O.S. has an NMI handler for handling the non-maskable Interrupts. 
Unlike the IRQs, the NMIs cannot be 'masked' (disabled) on the 5502. All the 
NMIs except SYSTEM RESET can be disabled on ANTIC. 

Two of the NMIs, the display list interrupt <DLI) and the vertical blank 
(VBLANK) interrupt, have RAM vectors that you can use. In fact, VBLANK can 
be intercepted In two places, Immediate or Deferred VBLANK. The NMI vectors 
are: 

Name Vector 

SYSTEM RESET none 

DISPLAY LIST INTERRUPT VDSLST C$0200] 

VERTICAL BLANK 

I MMED I ATE VVBLKI [S0222] 

DEFERRED VVBLKD C 50224] 



The SYSTEM RESET NMI doesn't have a RAM vector. SYSTEM RESET always 
results in a jump to the monitor warmstart routine (section 8.5) The DLI and 
the VBLANK Interrupts are covered In Chapter 5 and Appendix I respecr 1 ve I y . 
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nni n 




1 n PPKMSK 




$0010 










_ 


SD209 

>•* W *— W ml 




UZuc 




**n VkTPYPH 

Y INC i uu 


S 


S0208 

W W mm. W W 




none 
UZUL 




4U 1 KyClN 




<n?0F 




none 




*rj \ r\yw \ 


9 


1 ROEN 




0216 

W4&. 1 W 




46 VM1R0 


9 


$0216 




noon 




60 

w w 


«s 


$600 

mw w *r w 




0600 

w \mf \> w 


78 


80 START 


SE1 




DISABLE IRQS 


0601 

WWW 1 


AD 1602 

t \ W 1 W w *— 


90 


LDA 


VMIRQ 


REPLACE THE IRQ VECTOR 


0604 

w w w »^ 


8D4D06 


0100 

to* • ^r 7 to/ 


STA 


NBRK+1 


WITH OUR OWN 


0607 


AD1702 


01 10 


LDA 


VMIRQ+1 


ALL IRQS WILL 


060A 


8D4E06 


0120 


STA 


NBRK+2 


GO TO NBRK 


060D 

W Nrf W to»F 


A945 


0130 


LDA 


/IRQ&255 




060F 

W tor W • 


8D1602 


0140 


STA 


VMIRQ 




0612 

W W i *• 


A906 


0150 

to# * maW tor 


LDA 

MM *mmW W 


i IRQ/ 256 




061 4 

w w • ~ 


8D1702 


0160 


STA 


VMIRQ+1 




0617 


58 

tor 


0170 


CLI 




ENABLE IRQS 


0618 


AD0802 


0200 


LDA 


VKEYBD 


POINT KEY IRQ TO 


06 1C 


8D4306 


0210 

•mw •mm w 


STA 


JUMP+1 


RE? 


061 F 

wwii 


AD0902 


0220 


LDA 


VKEYBD+1 




0622 

w w m mm 


8D4406 

>^ / toX tor to** 


0230 


STA 


JUMP+2 




0625 

W W 4— ■mm' 


A939 


0240 

W w i Xr 7 


LDA 


#REPS255 


VECTOR KEY IRQ 


0627 

W W X. / 


8D0802 

W W W W W 4mm 


0250 

W 4.B ^ w 


STA 


VKEYBD 


LOW BYTE OF VECTOR 


062A 


A906 


0260 


LDA 


IREP/256 


062C 


8D0902 

www -? w 


0270 

W «M < W 


STA 


VKEYBD+1 




0638 

v w V w 


60 

WW 


0280 

W ttm w W 


RTS 










0290 


*=$639 




0639 

w w — « 


AD09D2 


0300 REP 


LDA 


KBC0DE 


ALL KEY IRQS COME HERE 


063C 

w WW w 


2980 

*mm m4 W W 


0310 

\mW \\\W \ W 


AND 


#S80 


CHECK IF CONTROL HIT 


063 E 


F002 

1 WW 4k 


0320 


BEQ 


JUMP 


IF NOT HIT THEN GO 


0640 

W W W 


68 

w w 


0330 


PLA 




ELSE IGNORE CON. KEY 


0641 

W W ~T 1 


40 

~ w 


0340 


RTI 






0642 


4C4206 

T toT? T W 


0360 JUMP 


J MP 


JUMP 


THIS CALLS THE OLD KEY IRQ 


0645 

w w ~ 


48 


0375 IRC 

W -mmS f %3W fl\ ^0 


PHA 




ALL IRQS COME HERE 


0646 


AD0ED2 


0380 


LDA 


IRQST 


CHECK IF <SREAK> 


0649 

W W ™T i T 


1 004 

1 W W "T 


0390 

*m*mm* m* W 


BPL 


BREAK 


IF <BREAK> IRQ BR. 


064B 

W W ~^m* 


68 

w w 


0405 


PLA 




ELSE CALL OLD IRQ VECTOR 


064C 


4C4CC6 

r V»r W >^ 


0410 NBRK 


J MP 


NBRK 


CALL OLD IRQ VECTOR 


064F 

W W r i 


A97F 


0430 BREAK 


LDA 


/S7F 


HERE IF <8REAK> 


0651 


8D0ED2 


0440 


STA 


IRQST 


SHOW NO <BREAK> 


0654 


A510 


0450 


LDA 


POKMSK 




0656 


8D0ED2 


0460 


STA 


IRQEN 




0659 


63 


0462 


PLA 






065A 


40 


0464 


RTI 




RETURN AS IF NO <BR£AK> 


06 5B 




0470 


*= 


S02E2 




02E2 


0006 


0480 


.WORD START 





FIGURE 8.8 IDIOT-PROOFING THE KEY30ARD 
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SECTION 8.4 - - THE SYSTEM VECTORS 

The O.S. has two types of vectors, ROM vectors and RAM vectors. ROM 
vectors are locations which contain JMP Instructions to system routines. RAM 
vector contain two-byte addresses .to system routines, handler entry pointers 
(see CIO section 8.2), or to Initialization routines. 

Both the ROM and RAM vector addresses are guaranteed not to change If 
ATARI releases a new O.S. but the contents of these vectors are free to 
change. The vectors, their contents and a brief description of their 
function are described In figures 8.9A and 8.9B. 

ROM VECTORS 



Use 

Disk handler Intia I I zatlon 
Disk handler vector 
Central Input/output routine vector 
Serial Input/ output routine vector 
Set system timers routine vector 
System vertical blank calculations 
Exit vertical blank calculations 
Serial Input/output Initialization 
Serial bus send enable routine 
Interrupt handler routine 
Central Input/output Initialization 
Blackboard mode (memooad) vector 
Warm start entry point (SYSTEM RESET) 
Cold start entry point (power-up) 
Cassette read block routine vector 
Cassette open for Input vector 



An example of using a ROM vector is: 
JSR CIOV 



FIGURE 8.9A ROM VECTORS 



Name 


Location 


D I SK 1 V 


5E450 


DSK1NV 


JE453 


CIOV 


SE456 


S10V 


SE459 


ScTVBV 


SE45C 


SYSVEV 


SE45F 


XITVBV 


SE462 


SI 01 NV 


SE465 


SENDEV 


SE468 


INTINV 


SE46B 


CIOINV 


SE46E 


BLKBDV 


SE471 


WARMS V 


SE474 


COLDSV 


SE477 


RBLOKV 


5E47A 


CSOP 1 V 


SE47D 
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Name 



Location Value 



YOSLST 

VPRCED 

V INTER 

YBREAK 

VKEYBD 

VSERIN 

VSEROR 

VSEROC 

VT1MR1 

VT1MR2 

YTIMR4 

ViMIRQ 

YVBLK I 

VVBLKD 

COTMA1 

CDTMA2 

CAS 1 N I 

DOS I N I 

DOSVEC 

RUNVEC 

INIYEC 

HATAES 



$0200 

$0202 

$0204 

$0206 

$0208 

$020A 

$020C 

$020E 

$0210 

$0212 

$0214 

$0216 

$0222 

$0224 

$0226 

$0228 

$0002 

$000C 

$000A 

S02E0 

$02E2 

$031A 

$03 1B 

$0310 

$03 IE 

$0320 

$0321 

$0323 

$0324 

$0326 

$0327 

$0329 

$03 2B 

S032E 

$0331 

$0234 

$0237 

$032A 

$03 AD 

$0340 



$E7B3 

$E7B3 

$E7B3 

SE7B3 

$FFBE 

$EB11 

SEA90 

$EAD1 

SE7B3 

$E7B3 

$E7E3 

SE6F6 

$E7D1 

SE93E 

$xxxx 

Sxxxx 

Sxxxx 

Sxxxx 

Sxxxx 

Sxxxx 

Sxxxx 
ipi 

$E430 

'C 
SE440 

•E' 
SE400 

«S« 

SE410 
'K ' 

$E420 

«x' 

'x' 

'x' 

'x' 

'x' 

»x» 

'x' 



RAM VECTORS 

Use 

Display List Interrupt NMI Vector 

Proceed Line IRQ Vector - Unused at JjrjJJJt 

inSrruot Line IRQ Vector — Unused at Present 

SofSare Break Induction IRQ Vector 

Keyboard IRQ Vector 

Serial Input Ready IRQ Vector 

Serial OutputReady IRQ Vector 

Serial Output Complete IRQ Vector 

POKEY Timer 1 IRQ Vector 

POKEY Timer 2 IRQ Vector 

POKEY Timer 4 IRQ Vector 

Immediate IRQ Vector to IRQ Handler 

Vertical Blank NMI Vector 

Deferred Vertical Blank Vector 

System Timer 1 JSR Address 

System Timer 2 JSR Address ,*t+t*i tzatlon 

Vector for bootable cassete program Initialization 

Disk Initi llzatlon Vector 

Disk Software Run Vector 

nnp File Load and GO Run Vector 

SuP File Load and Go Initialization Vector 

Printer Device I .0 

Address of Printer Entry Points Taoie 
X^mfor Entry Ml. 

EZ?tf l £Jlfowt ^ P0,n+ T36,e 

^rZ^VJrtn^ Entry Point Tafil« 
HATABS Unused Entry 1 



t~ i 



X 



ti 
ti 

Tl 

ti 
ti 

Tf 
11 



ft 

tl 

tf 

11 

tl 
tl 
tl 
II 



71 
It 
tl 
It 
tl 
tl 
tl 

11 



3 
4 

5 
6 
7 

8 

9 



An x indicates c° n+en V S u 

An example of using a RAM vector 

JSR CALL 
CALL JMP (DOS INI) 



Is: 



FIGURE 8. 98 RAM VECTORS 
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0600 
OOOC 
02E7 
3000 



0000 

0600 
0603 
0605 
0608 
C60A 



200D06 
A900 
8DE702 
A930 
8DE802 



0600 60 



060E 
0610 
0613 
0615 
0618 
061A 
061C 
061E 
0620 
0622 
0625 
0627 
062A 
062S 
02E2 
02E4 



A50C 
8D01C6 
A50D 
8D0206 

A900 
850C 
A906 
8500 
A500 
8DE702 

A930 
8DE802 
60 



0E06 



0010 
0030 
0040 
0050 
0060 
0070 ; 
0090 ; 
0100 ; 
0120 ; 
0130 ; 
OUO j 
0150 ; 
0160 : 
0180 
0190 
0200 
0210 
0220 
0230 
0240 
0250 
0260 
0270 
0280 
0290 
0300 
0330 
0350 
0370 
03 90 
0400 
0410 
0420 
0430 
0440 
045C 
0460 
0470 
0480 
0^90 
0500 
0510 
0520 
0530 
0540 



; WRITTEN BY. ..MICHAEL EKBERG 
START ■ $600 
DOS INI ■ $ oc 

t MEMLOIS SET TO THE VALUE OF NEWMEM . 



THIS PART IS PERMANENT, IE. NEEDS ™ BE RESIDENT. 
THE SYSTEM DOS I NIT VECTOR HAS BEEN STOLEN 
AND StSS IN THE ^^.TO0S^2. 
DOS IS INITIALIZED AND MEMLO IS INITIALS 
INITDOS EXECUTES ON LRESETJ. 



INITDOS 



JSR 
LDA 

STA 
LDA 
STA 



START 

CYNTHIA ; DO DOS INITLIST 

#NEWMEM&255 

MEMLO 

#NEWMEM/256 
MEMLO+1 



CYNTH 1 A 



• TH I S PART I S EXECUTED AT POWER UP ONLY AND 

\ CAN BE DELETED AFT ! R ^ W ^"H£* T . 0F D0 S1N1 INTO A JSR 
THIS ROUTINE STORES TrC CONTEN TS OF DOS IN. 
AT LOCATION INITDOS+1. h THEN RtP^i 
|T»S OWN VALUE, THE LOCATION INITDOS. 
JACKIE SAVE 00S , N1 



0550 



LDA DOS INI ! 
STA INITDOS+1 
LDA DOSINI+1 
STA INITDOS +2 
LDA #!NIT00S&255 
STA DOSINI 
LDA # INITDOS/ 256 
STA DOSINI+1 
LDA NEWMEM&255 

STA MEMLO 

LDA #NEWMEM/256 

STA MEMLO+1 

RTS 

*= S2E2 

.WORD JACKIE ; 

.END 



SET DOS INI 



SET MEMLO 



SET RUN ADDRESS 



FIGURE 8.10 MEMLO MOVER 
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SECTION 8.5 - - THE MONITOR 

* 

The O.S. monitor Is a program In ROM that handles both the system 
power-up and SYSTEM RESET sequences • The power-up and SYSTEM RESET sequences 
are similar In function and In fact share much of the same code. Appendix IV 
has a flowchart of the power-up and SYSTEM RESET routines. 

The power-up routine (also known as coldstart) Is Invoked either by 
turning on the computer or by jumping to COLDSV C$E477H. COLDSV Is the 
system routine vector to the power-up routine. Important Items to remember 
about the power-up are:. 

1. ALL of memory Is cleared except locations 
50000-S000F 

2. Both a cassette and disk boot are attempted. 
BOOT?C$0009n Is a flag that Indicates the success or 
failure of the boots. Bit 0=1 If a successful cassette 
boot; Bit 1 - 1 If a successful disk boot. 

3. COLDSTCS0244] is a flag that tells the Monitor 
that It Is In the middle of power-up. C0LDST=0 means 
System Reset, C0LDST<>0 means power-up. An Interesting 
use of COLDST Is to set It to a non-zero value during 
execution of an application program. This will cause a 
SYSTEM RESET to become a power-up. This technique may 
add a measure of security by preventing a user from 
gaining control of the computer while an application Is 
running. 

Pressing the < SYSTEM R£SET> key causes a SYSTEM RESET (also known as 
warmstart) • Some of the key facts to remember about SYSTEM RESET In the 
flowchart In Appendix IV are: 

1. The O.S. RAM vectors are downloaded from ROM both 
during SYSTEM RESET and power-up. If you wish to f steal ! 
a vector, some provision must be made to handle SYSTEM 
RESET. See Chapter 9 on how to handle SYTEM RESET. 

2. MEMLO,MEMTOP,APPMHI ,RAMS!Z, and RAMTOP are reset 
during System Reset, if you wish to alter these user RAM 
pointers to reserve some space for assembler modules 
called by BASIC, some provision must be made to handle 
SYSTEM RESET. Figure 8.10 Is an example on how to do this. 
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The system ^-^^ 

The system ^abese occup les RAM pages ?^£2E^'t»~ 
database contains system flags, '^vl ^features not supplied by either 
can use some of these locations to P™'<J *JJ * Figure 8.11 describes some 
the O.S. or a program environment (I.e. BASIL;, r.g 
of these elements of the database. 

DATA BASE CHART 



Location 
Name ,S!ze I nit. by 



Value Function 



MEMLO 

MEMTOP 

APPMH I 

RAMTOP 

RAMSIZ 

POKMSK 

BRKKEY 



S02E7.2 
$02E5,2 
SOCOE 
$006A,2 

$02E4,1 

$0010,1 
$0111,1 



IRQEN $D20E 
PTIMOT $001 C 
CIOCHR $002F 



R,P 
R,P 
P,R 
P,R 
P,R 
P,R 
P,R 

P,R 
P,R 



ZIOCS $0020,16 
BOOT? $0009,1 P,R 



CKEY 
CASSBT 
KEC0DE 
CH 

CH1 
SHLCK 

KEYDEL 

SSFLAG 

ATRACT 

SRTIMR 

C0LDST 

WARM ST 

CHBAS 
CRITIC 



$004A,1 P 
$004B P 
$D209,1 
$02FC P,R 
$02F2,1 
$02SE,1 P,R 
SC2F1 ,1 

$02FF,1 

$0040,1 

$0223,1 

$0244,1 

$0008,1 

$C2F4,1 P,R 

$0042 P,R 



x 
x 

$00 

x 

X 
X 

$FF 
x 

X 
X 



X 

SFF 

x 
$40 
$03 

x 



$E0 



User Free Memory Low Address 

User Free Memory High Address 

User Free Memory Screen lower limit 

Display Handler Top of RAM Address(msb) 

Top of RAM Address (msb) 

O.S. IRQ enable shadow 

BREAK key flag; $FF means no 

BREAK key hit 

ANTIC IRQ enable bit register 
Printer timeout value for SI0 
CIO temp storage for PUT a single 
char function 
CIO ZERO page I/O BLOCK 
Boot Flag; bit 0 is 
bit 1 Is DOS 

Monitor Cassette boot flag 
Cassette boot flag 
Keyboard code register 
Current key value 
Last keyboard value 
Shift lock 

Keyboard so+ware debounce timer 
Start/ stop flag for display 
ATRACT mode flag 
ATRACT mode timeout timer 
in it flag 
inlt flag 

Pointer to character base 
Critical I/O region flag 



P means power-up 

R means SYSTEM RESET 

x means value varies 



FIGURE 8.11 SYSTEM DATA BASE 
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MEMORY POINTERS 

The O.S. uses five locations to keep track of the user and display 
memory, MEMLO, MEMTOP, APPMHI, RAMTOP, and RAMS1Z. Their relationships are 
shown In figure 8,12, a simple system memory map. 

MEMLO Is a two-byte location that the O.S. uses to Indicate where an 
application program may begin. Used carefully, MEMLO can be used to create 
areas for assembly language modules that may be called from BASIC. BASIC 
uses the value of MEMLO to determine the starting location of a program (see 
the BASIC chapter for the structure of a BASIC program). If we desire to set 
MEMLO to a higher address, we must set It before the BASIC cartridge Is run. 
MEMLO has to be used carefully because It Is reset by both power-up and 
SYSTEM RESET. 

If the system will be booted from a disk drive then the AUTORUN.SYS 
facility can be used to set MEMLO to a predefined value. Because the DOS 
also resets MEMLO dsrtng SYSTEM RESET via the DOS I N I vector, DOSINI needs to 
f stoIen f . DOSINI contains the address of the DOS initialization code called 
as part of the monitor system initialization. DOS still needs to be 
initialized as part of SYSTEM RESET. The contents of DOSINI must be moved 
Into the two-byte address of a JSR instruction as part of the power-up. 
DOSINI Is then set to the address of the JSR instruction for the 
Initialization code and MEMLO Is set to the predefined value. When a SYSTEM 
RESET occurs, the new Initialization code Is called and the first insruction, 
JSR OLDDOS INI, I n It !a I ! zes DOS . The new initialization code sets MEMLO to 
the predefined value and RTSs to the old Initialization sequence. Figure 
8.10 Is an example on how to do this. 

The above technique can also be used with MEMTOP, the user high memory 
pointer. Space for assembly modules and data can be set aside by lowering 
MEMTOP from the values set by power-up and SYSTEM RESET. Using MEMTOP 
Instead of MEMLO creates one problem. MEMTOP fluctuates due to both the 
amount of RAM in the system and the graphics mode of the display. This makes 
It difficult to predict Its value before actually examining the location 
unless you make some assumptions about the system. As a result ali assembly 
modules may need to be relocatable. 

APPMHI Is a location which contains an address that specifies the lowest 
address the display RAM may be placed. Setting APPMHI insures that the 
display handler will not clobber some of your program code or data. 

RAMS I Z, like MEMTOP, can also be used to reserve space for assembly 
modules. The advantage of R/MSIZ over MEMTOP Is that the space saved by 
moving RAMSIZ down is~above the display. Space saved by moving MEMTOP down 
remains below tne display. The display area expands and contracts depending 
on the graphics mode. 
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OS 



MEMLO 2E7.2EB 



APPMHI OE,OF 



MEMTOP 2E5,2E6 
SDL ST 230,231 



SAVMSC 58,59 



TXTMSC 294,295 



RAMTOP 6A 
RAMSIZ 2Ei 



MEMORY MAP 



RAM 



PAGE 
SIX 



DOS 



BASIC 
TOKEN 
PROGRAM 



FREE 
RAM 



DISPLAY 
LIST 



SCREEN 
RAM 



TEXT 
WINDOW 



BASIC 



80,81 LOMEM 



90,91 MEMTOP 
QE,OF APHM 

I 

FRE(Q) 

I 
I 

2E5,2E6 HIMEM 



OS AND BASIC POINTERS (DOS PRESENT) 



FIGURE 8.12 
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MISCELLANEOUS 

ERKKEY Is a flag that is set when the O.S. senses that the <BREAK> key 
has been pressed* BRKKEY's normal* value Is SFF • If It changes, then the 
<BREAK> key has been pressed. The <BREAK> key IRQ (not the software 
Instruction BRK IRQ) must be enabled for the O.S. to sense the <BREAK> key. 

The computer's printer timeout value ts stored In a RAM location called 
PT1M0T. It contains the value of the timeout period for SIO In seconds. It 
may be altered to Increase or decrease the timeout period by placing a new 
value In PTIMOT. PTIMOT Is Initialized to 30 seconds, and ts updated each 
time the printer is opened. Typical timeout for the 825 is 5 seconds. 
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1 POKE 752,1: GOTO 3 

3 ? "t":REM clear screen 

4 ? "HOUR" ; : I NPUT HOUR: ? "MINUTE ";: INPUT MIN: ? "SECOND";: INPUT SEC 

5 CMD-1 :GOSUB 45 

6 ? "t";HOUR;" : ";MIN;" : ";SEC:? »":?«« 

7 CMD=2:G0SUB 45 

9 ? "";HOUR;":";MIN;":";SEC;" ":GOTO 7 

10 REM THIS ISA DEMO OF THE REAL TIME CLOCK 

20 REM THIS ROUTINE ACCEPTS AN INITIAL TIME I HOUR, IMI N, I SEC 
30 REM IT SETS THE REAL TIME CLOCK TO ZERO 

40 REM THE CURRENT VALUE OF RTCLOCK IS USED TO ADD TO THE INITIAL TIME TO GET 
THE CURRENT TIME HOUR, MIN, SEC 
45 HIGH=1536:MED=1537:L0W=1538 

50 REM 

60 REM ******EN7RY POINT****** 
65 REM 

70 ON CMD GOTO 100,200 

95 REM 

96 REM **** INITIALIZE CLOCK***** 

97 REM 

100 POKE 20,0:P0KE 19,0:POKE 18,0 

105 DIM CLOCKS (50) 

106 CLOCKS=" " :GOSUB 300 

110 IHOUR=HCUR: IMI N=MI N: I SEC=SEC: RETURN 

197 REM 

198 REM *******READ CLOCK***** 

199 REM 

200 REM 

201 A=USR(ADR( CLOCKS) ) 

210 TIME=( ( ( ( PEEK ( H I GH) *256 ) +PEEK ( MED ) ) *256 ) +PEEK ( LOW ))/ 59 . 923334 
220 HOUR= I NT ( T I ME/3 600 ) : T I ME=T l ME- ( H0UR*3600 ) 
230 MIN=INT(TIME/60):SEC=INT(TlME-(MlN*60)) 

235 SEC=SEC+ISEC: IF SEO60 THEN SEC=SEC-60:MI N=MI N+1 

236 Ml N=MI N+IMI N: I F MIN>60 THEN Ml N=MI N-60:H0UR=H0UR+1 

237 HOUR=HOUR+ 1 HOUR 

' 240 HOUR»HOUR-< INT(H0UR/24) )*24 
250 RETURN 



FIGURE 8.13 - - REAL TIME CLOCKS 

300 FORM TO 38: READ Z:CLOCKS( I , I )=CHRS(Z) :NEXT I: RETURN 

310 DATA 104,165,18,141,0,6,165,19,141,1,6,165 

320 DATA 20,141,2,6,165,18,205,0,6,208,234 

330 DATA 165,19,205,1,6,208,227,165,20,205,2,6,208,220,96 
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SECTION 8.7 - - TIMERS 



THE SYSTEM TIMERS 

There are two types of timers provided for you to use. System timers 
run at the frequency of the T.V. frame. For North American television (NTSC) 
the rate Is 59.923334 hz. European (PAL) televisions run at 50 hz. The 
FOKEY timers are clocked by frequencies setable by the user. 



There are 6 system timers: 



Name 

RTCLOK 
CDTMV1 
C0TMV2 
CDTMV3 
C0TMV4 
CDTMV5 



Locat ion 

[50012,3] 
[50218,2] 
[S021A,2] 
[S021C,2] 
[5021 E, 2] 
[50220,2] 



Vector or f I 



none 

CDTMA1 [50225,2] 
CDTMA2 [50228,2] 
C0TMF3 [S022A,1] 
CDTMF4 [5022C,1] 
CDTMF5 [S022E,1] 



All of the system timers are clocked as part of the vertical blank 
(VELANK) process. If the V BLANK process is disabled or Intercepted, the 
timers will not be updated. 

The reai time clock(RTCLCK) and system timer 1 (CDTMV1) are updated 
durtng Immediate VBLANK, Stage 1. RTCLOK counts up from 0 and Is a threi 
byte value. When RTCLOK reaches Its maximum value (16,777,215) it will be 
reset to zero. RTCLOK can be used as a time piece as example 8.13 shows. 

Because the system timers are updated as part of the VBLANK process, 
special care Is needed to set them correctly. A system routine called SETVBV 
[5E45C] Is used to set them. The call to SETVBV Is: 

REG's:X,Y contain the timer value. 

A contains the timer number: 

A- 1-5 - - TIMERS 1-5 



LDA #1 
LDY tQ 
LDX #02 
JSR SETVBV 



;Set system timer 1 

j value is 5200 VBLANK S 

;Cail system routine to set timer. 
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5 ? »t" :REM BASIC ROUTINE TO 

7 REM BY M.EKBERG FOR CARLA 

10 X-10: FOR 1=1 TO 2 STEP 0 

20 TOP=10: FOR J=1 TO TOP : NEXT J 

50 IF STICK(0)=13 THEN X=X+1 :REM. 

51 IF STICK(0)=14 THEN X=X-1 :REM 

52 IF X<1 THEN X s 1 : REM 

53 IF X>255 THEN X=255:REM 

54 REM 

56 ? ""; INT(3600/X); n BEATS/MINUTES 
60 POKE 0,X:REM 
70 NEXT I :REM 



SET THE RATE OF A METRONOME 



SOFTWARE DELAY LOOP 
STICK FORWARD MEANS SPEED UP RATE 
STICK BACK MEANS SLOW METRONOME RATE 
NEVER GO BELOW ZERO 
OR ABOVE 255 

PRINT BEATS/MINUTE 
it 

L0ACT10N SOOOO HOLDS THE RATE FOR 
THE FOLLOWING ASSEMBLY ROUTINE 



40 *=S600 

50 ; METRONOME ROUT! NE. ..USES $0000 PASS THE METRONOME RATE 
60 : 



70 AUDF1 


= 


SD200 AUDIO FREQUENCY REGISTER 


80 AUDC1 




5D2Q1 AUDIO CONTROL REGISTER 


90 FREQ 


■ 


S08 AUDF1 VALUE 


0100 VOLUME 




SAP AUDC1 VALUE 


0110 OFF 




SAO TURN OFF VOLUME 


0120 SETVBV 




SE45C SET TIMER VALUE ROUTINE 


0130 XITVBV 




SE462 


0140 CDTMV2 


s 


S021A TIMER 2 


0150 CDTMA2 


s 


$0228 TIMER 2 VECTOR 


0160 ZTIMER 




SOOOO ZPAGE VBLANK TIMER VALUE 


0170 ; 






0180 START 


LDA 


#10 


0190 


STA 


ZTIMER 


0200 I NIT 






0210 ; 


SET THE 


TIMER VECTOR 


0220 ; 






0230 


LDA 


/CNTI NT&255 


0240 


STA 


CDTMA2 


0250 


LDA 


#CNT1 NT/256 


0260 


STA 


CDTMA2+1 


0270 ; 






0280 ; 


SET THE 


TIMER VALUE AFTER THE VECTOR 


0290 ; 






0300 


LDY 


ZTIMER SET TIMER TWO TO COUNT 


0310 


JSR 


SET! ME 


0320 


RTS 
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0340 ; METRONME COUNT DOWN VECTORS TO HERE 

0350 ; 
0360 CNTINT 
0370 

0380 ; SET UP AUDIO CHANNEL FOR MET CLICK 

0390 



0400 




LDA 


JVOLUME 


0410 




STA 


AUDC1 


0420 




LDA 


/FREQ 


0430 




STA 


AUDF1 


0433 




LDY 


#$FF 


0437 


DELAY 






0440 




DEY 




0442 




BNE 


DELAY 


0450 




STY 


AUDC1 


0460 




JMP 


IN1T 


0470 








0480 








0490 




SUBROUTINE TO SET 


0500 








0510 


SETIME 






0520 




LDX 


#0 


0530 




LDA 


02 


0540 




JSR 


SETVBV 


0550 




RTS 




0560 




*=52E2 




0570 




.WORD 


START 


0580 




.END 





DELAY 



NO TIME >256 VBLANKS 
SET TIMER 2 

SYSTEM ROUTINE TO SET TIMER 



FIGURE 8.14 - - METRONOME 
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System timers 1-5 are two byte counters. They nay be set to^va ue 
using the SETVBV routine. The , °' S ' m £l T Timers 2-5 are 

Timer 1 Is decremented during l--JJ«*« H^'oiffSUi actions are taken by 
decremented during Immediate VBLANK, Stage z. u ' T I_ere 
the o!s when the different timers are decremented to 0. 

ngure 6 » gives the vectors for the t»o tl«r». 

System tM 3-5 have flags that are normaHy «T < I ^ 
S&fc* £ r^WS r^aS^e appropriate action. 

Timers ,-5 are general purpose soft.are t . ^JfitfXStfJ Zr*. I 

variety of appl SSiViSb « « A.2 operation Is 

bus operations. If the timer coun.s ro . . var i 0 us values 

complete, a 'timeout; error ^ returned. T mer II s set to vjr ^ 
depending on the device being accessed. This Insures 

has ample time to answer an I/O request, .ne c Tlmer 3 , s aiso 

indefinltly waiting for a non-exlstant device to respc pf +ime 

used by the O.S. The cassette handler uses %™ p 2 +Q ou+pu+ a SOU nd 

to read and write tape headers. Exam pie 8 14 use ^f^,^ va|ues by 
used as a metronome. The metronome's rate can be sex to 
using a joystick. 
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INTRODUCTION 

The Disk Operating System (DOS) Is an extension of the O.S. that allows 
you to access disk drive mass storage as flies. You can access disk files 
just like other flies. Let's discuss the parts of DOS, then we will discuss 
how to use DOS. 

The Disk Operating System (DOS) has three parts, the resident disk 
handler, the File Manager (FMS) and the Disk Utility Package (DUP) . The 
resident disk handler Is the only part of DOS In the O.S. ROM, FMS and DUP 
are located on diskette and are loaded (footed 1 ) Into the computer on 
powei — up . 

THE RESIDENT DISK HANDLER 

The resident disk handler is the simplest part of DOS, The disk handler 
does not conform to the normal CIO cat ling sequence as does the other Device 
Handlers- The relationship of the Disk Handler to the I/O subsystem is shown 
In Figure 8.1 In section 8.2 of this bock. 

From figure 8.1 we can see that the DCS Is the way to communicate to the 
Disk Handler. The calling sequence for the Disk Handler Is: 

; caller has set up DCS 
JSR DSKINV ; system routine vector to the resident disk handler 
BPL OKAY ; Branch If success, Y Reg . ■ 1 

;Else y reg. - error status (DC3STA also has error) 

The disk handler supports five functions: 

FORMAT Issue a Format command to the Disk Controller. 

READ SECTOR Read a specified sector. 

WRITE SECTOR Write a specified sector, 

WRITE/VERIFY SECTOR Write sector, check sector to see If written. 
STATUS Ask the disk controller for Its status. 



The FORMAT command clears all the tracks on the diskette and the sector 
addresses are written on the tracks. No file structure Is put on the 
d! skeTte by this command. 

The three sector I/O commands can be used to read and write sectors on 
the diskette. You can use them to Implement your own file structure. 
Section 10 of the O.S. Manual has an example of using the disk handler to 
write a boot file. 

The STATUS function is used to determine the status of the disk 
drlve(s). You can use the Status command for several purposes. Since the 
timeout for a Status command Is smaller then the ether commands, you can use 
It to see If a specific disk drive Is connected. If the Disk Handler returns 
a device timeout error, you know the disk Is not connected. 
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DUP 

DUP (Disk Utility Package) Is a set of utilities for diskettes, 
familiarly seen as l2 DOS menu. DUP executes commands by calling FMS 
through CIO. The commands are: 

A. DIRECTORY 

B. RUN CARTRIDGE 

C. COPY FILES 

D. DELETE FILES 

E. RENAME FILES 

F. LOCK FILES 

G. UNLOCK FILES 

H. WRITE DOS FILES 
I . FORMAT D I SK 

J. DUPLICATE DISK 
K. SAVE BINARY FILE 
L. LOAD BINARY FILE 
M. RUN AT ADORESS 
N. WRITE MEM.SAV FILE 
0. DUPLICATE FILE 



FMS 



Tt ^rlr^o^M^^. » n t..„>n/D M .s present. 

FMS, Ilk. th. other device handlers get . I/O f , ^7"^° i , 
FMS then'uses the resident dlsl . h« « «r to do I/O to t e^ skett e ^ 
called by setting up an IOCS and call ng CIO. rra pp 
functions net available to other handlers. 

forma t *^^Ti^!ra"-VS mess. 

data on the diskette. 
NOTE FMS returns the current file pointer. 
POINT FMS sets the file pointer to a specified value. 



DISK I/O 

You can access all the standard file I /0 ca I « s through CIO In BASIC 

this means using the I/O "^•^^oS^SK'"^ CO. Let's 
assembly language you have to set up the •«» g 
use BASIC to provide an easy introduction . o DCS. 
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To do any disk I/O, you must first OPEN a file. The BASIC syntax for 
the OPEN Is: 

OPEN #I0C8,lCAX1,0, n D:MYPR0G.BAS" 

The #iOCB selects one of the 7 lOCSs available from EASIC (BASIC Itself 
uses I0CB #0). ICAX1 Is the OPEN type code. The bits for the type code are: 

BIT 7 6 5 5 3 2 1 0 
xxxxWRD A 

Where: A Is Append 

D Is Directory 
R Is Read 
W Is Write 
x Is unused 

The various values for ICAX1 are discussed In section 5 of the O.S. Manual. 
Some of the key things to note about the various OPEN modes are: 

ICAX1=6 This Is used to OPEN the diskette directory. Records READ 

are the diskette directory entries. 
ICAX1=4 READ mode. 

ICAX1=8 WRITE mode. Any file 0PEN f ed In this mode Is deleted. The 

first bytes written will be at the start of the file. 
ICAX1=9 WRITE APPEND mode. The file is left Intact. Bytes written 

to this file are put at the end of the file. 
ICAX1*12 UPDATE mode. This mode allows both READ and WRITE to the 

file. Bytes READ/WRlTE ? en start at the first byte In the 

file. 

ICAX1»13 Not supported. 

Now that we knew how to OPEN a file, let's see how to transfer data 
between our program and the disk. There are two types of I/O you can use, 
record or character. 

Character I/O simply means that the data In a file is one list of bytes. 
DOS Interprets this list of bytes as data (no Imbedded control characters). 
This Is an example of character data (ail values hex): 00 23 4F 55 FF 34 21. 

Record I/O means that data In a file is made up of a set of records. A 
record Is a group of bytes delimited by an EOL (S93). This is an example of 
two records: 

00 23 4F 55 FF 34 9B 21 34 44 93 
! record 1 ! record 2 I 
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As a matter of fact, data createa as rww T , difference 

ssrs?^? ■- r r^^ , .~ a?% SS f-d A. s» ,s 

wld Is ordinary data .hen using character I/O. 

BASIC support* record ,/0 gttjr-.j ; ; Jne i^f suSpcr?"" 

read and write a single byte at a time. 

The O.S. has the ability "rfa^^T^tS^M™' 
ability is not used by BASIC. Besides t!» l»Sl character block 

allows you to specify the address of +he bloc* o t0 be 

,cde of\h. O.S. free, BASIC, you oan -rlte an A. -°^ tUn S 8 . 2 of th , s 

fciiH^ e A xaIp,S Y or e a foar^* do character bloc. I/O. 

RANDOM ACCESS 

One of the »ost Important uses of 
STJ^.l'iSi'SS 3%0,« tt- the oreat.cn and use of 
random access files. 

NOTE and POINT reed and updt. th^fl I • polntjr respectively. ***** 
a file pointer for each f 1 1 e «rranty OPEN * ^ .au ^ number 

location in the file. The file po intar has T*o pa +he DQS 

and the byte count The sector mM er a value rem ^ ^ ^ ^ 
wh,t «ctor on the diskette the Tile poinTer - a 5ec +or has a 
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E E E 

0 0 0 

A B CLOE FLGH I JkL AB 

File 41 42 43 9B 44 45 46 9B 47 48 49 4A 4B 9B...41 42 

FI le Potnter 

Sector 

Number 50 50 50 50 50 50 50 50 50 50 50 50 50 50... 50 51 
Byte 

Count 0 1 23456789A6CD...7C0 

The above file was created in BASIC by: 
10 OPEN #1,8,0,"0:FILE" 
20 ?#1;"ABC" 
30 ?#1;"DEF" 
40 ?#1;"GHIJ" 

a 

2 :REM Fill the rest of the sector 

100 ?#1;"AB" :REM This writes a record that crosses end of sector 
150 CLOSE #1 

FIGURE 9.1 NOTE AND POINT VALUES 

The sector number is 50 because DOS arbitrarily started this file on 
sector 50. The sector number changes to 51 because the file Is longer than a 
sector. DOS linked the file to the next available sector, 51. The record 
n AB" crosses the end of the first sector. 

The byte count of the file pointer starts at 0 and Is Incremented until 
the end of the sector, $7D (125 Dec). DOS reserves the last 3 bytes of 
every sector for overhead data for the file. For files on the 810, the 
maximum byte count Is 124 (0-124 = 125 total bytes). The maxlmun for the 815 
Is 252 (253 total bytes). When the file reaches the end of a sector, the 
Byte Count resets to 1 . 

You should now have a good Idea how records are stored on the diskette 
and how to re+reive them. Figure 9.2 Is a subroutine to save records, keep 
track of where they are, and retrieve them. Appendix VIII Is a complete 
random access method written in Basic. 
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1000 REM THIS ROUTINE CREATES AND ACCRESSES RANDOM ACCESS FILES FOR FIXED 
LENGTH RECORDS 

1001 REM COMMANDS ARE 

1002 REM CMD=1 WRITE NTH RECORD 

1003 REM CMD=2 READ NTH RECORD 

1004 REM CMD=3 UPDATE NTH RECORD 

1005 REM 

1006 REM RECORDS IS THE I NPUT/OUTPU RECORD 

1007 REM N IS THE RECORD NUMBER 

1010 REM INDEX I S A TWO DIMENSINAL ARRY DIM'ED I NDEX( 1 ,RECNUM) . INDEX HOLDS 

THE NOTE VALUES FOR ALL RECORDS 

1020 REM I0CS1 IS THE ASSUMED DATA FILE 

1100 REM 

1200 ON CMD GOTO 2000,3000,4000 
2000 REM 

2100 REM WRITE NTH RECORD 
2200 NOTE #1,X,Y 

2300 INDEX(SEC,N)=X: I NDEX(BYTE,N)=Y 
2400 ? #1 ; RECORDS: RETURN 
3000 REM 

3010 REM READ NTH RECORD 
3020 REM 

3030 X=INDEX(SEC,N) :Y=INDEX(BTTE,N) 
3040 POINT #1,X,Y 
3050 INPUT #1 ;RECORDS 
3060 RETURN 
4000 REM 

4010 REM UPDATE NTH RECORD 
4020 REM 

404U X=l NDEX( SEC,N) : Y=l NDEX(BYTE,N) 
4050 POINT #1,X,Y 
4060 ? #1 ; RECORDS 
4070 RETURN 



FIGURE 9.2 NOTE AND POINT EXAMPLE 
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VERTICAL BLANK INTERRUPTS 



The ATARI 400/800 provides a number of Interrupts which can be of great 
value. This appendix will cover vertical blank Interrupts. These Interrupts 
are non-maskable Interrupts which occur every 60th of a second during the 
vertical blank time of the television display. They have a wide variety of 
uses. 

At the beginning of vertical blank ANTIC pulls down the NMI line on the 
6502. The 6502 then vectors to an NMI service routine which determines the 
source of the Interrupt. If It Is a vertical blank Interrupt, the 6502 Jumps 
through the Immediate vertical blank vector ( VVBLK I ) located at $0222. This 
vector normally points to the OS vertical blank Interrupt service routine at 
SE45F. This routine terminates by jumping through the deferred vertical blank 
Interrupt vector (VVBLKD) at $0224. Normally this vector points to a simple 
Interrupt termination routine at SE462. Figure 1.1 Illustrates this process. 



VERTICAL BLANK 
I NTERRUPT 



0PERATI NG 
SYSTEM 
TEST 




/ VVBLK l\ my o^a 




i 



SYSVBV <, j 

(SE45F) ^ 



OS VBI 
SERVICE 
ROUT I NE 



JSJE* <t /vvblkd\ 

! * 

(SE462) 




RTI 



F Igure i . 1 

normal vertical blank Interrupt execution 
a*d Kou) io steal »H 



These two vectors were put Into RAM to allow the programmer to trap the 
Interrupt service routine and use the 60 Hertz Interrupt for her own 
purposes. The procedure to use them Is rather simple. First decide whether 
the vertical blank Interrupt (VBU routine Is to be an Immediate VBI or a 
deferred VBI • In many cases It makes little difference which Is chosen. There 
are only a few cases where It matters. The first case arises when your VBI 
routine reads or writes to registers which are shadowed by the OS VBI 
routine. For example, It may be necessary to write to the hardware registers 
after the OS VBI routine has written to them so as to have the last word, so 
to speak. 

The second case arises when your VBI routine consumes too much processor 
time. The OS VBI routine may be delayed beyond the end of the vertical blank 
period. This In turn may cause some graphics registers to be changed while 
the beam Is tracing on the screen. The result may be unsightly. If this is 
the case, your VBI routine should be placed as a deferred VBI routine. Your 
time limit for Immediate VBI routines Is about 3000 machine cycles; for 
deferred VBI routines It Is up to 25,000 cycles. However, these 25,000 
machine cycles are executed while the electron beam Is being drawn, so 
araphics operations should not be executed In deferred VBI routines. 
Furthermore, display list Interrupt execution time comes out of the time 
available for this processing. Furthermore, VBI processing time comes out of 
the mainline execution time. 

The third case arises when your own vertical blank interrupt must be 
mixed with time-critical I/O such as disk or cassette 1/0. The OS vertical 
blank interrupt routine has two stages, a critical and a non-critical stage. 
During time critical I/O, the OS VBI routine aborts after stage one 
processing Is comolete. If you do not wish your own VBI routine to be 
disabled during time-critical 1/0, you must define It as an Immediate VBI 
routine. The delays you thereby create may interfere with time-critical 1/0. 
That f s your problem. 

Once you have decided whether your VBI routine should be immediate or 
deferred, you must place the routine In memory (page six Is an excellent 
place), link Its termination to the regular VBI processing, and modify the 
appropriate OS RAM vector to point to It. Terminate an Immediate VBI routine 
with a JMP to SE45F. Terminate a deferred VBI routine with a JMP to SE462. If 
you desire to bypass the OS VBI routine entirely (and so save some processing 
time), terminate the Immediate VBI routine with a JMP to SE462. 

A common problem with interrupts on 8-bit micros arises when you try to 
change the vector to the Interrupt. Vectors are two-byte quantities; it takes 
two store instructions to change them. There Is a small chance that an 
interrupt will occur after the first byte has been changed but before the 
second byte has been changed. This would crash the system. The solution to 
this problem Is provided by an OS routine called SETVBV at location SE45C. 
Load the 6502 Y-reglster with the low byte of the address, the X-register 
with the hlah byte of the address, and the accumulator with a 6 for Immediate 
VBI or a 7 for deferred YBI . Then JSR SETVBV and the interrupt will be safely 
enabled. It will begin executing within one 60th of a second. 
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A wide variety of operations can be performed with 60 Hertz Interrupts. 
First, screen manipulations can be done during the vertical blank to Insure 
that transitions do not occur on screen. Second, high speed regular screen 
manipulations can be performed. This Is Important In showing many types of 
animation. For example, the bubbles In the nuclear reactor program SCRAM* 
must move at a regular pace. They must not speed up or slow down as other 
computational activities burden the 6502. The only way to assure the 
regularity of their motion Is to perform the animation during a vertical 
blank Interrupt. 

Another function of vertical blank Interrupts Is for sound envelope 
generation. The sound registers In the ATARI 400/800 allow control of 
frequency, volume, and distortion, but not duration. Duration can be 
controlled with a vertical blank Interrupt by having the calling routine set 
a duration parameter. Then the vertical blank Interrupt routine decrements 
any nonzero duration parameter and turns off the sound when the duration 
parameter reaches zero. This technique can be used to control the volume of 
the sound and so give attack and decay envelopes to sounds. Control of 
frequency and distortion Is possible with extended versions of this 
technique. These techniques can produce very Intricate sound effects. 

Vertical blank interrupts are also useful for handling user Inputs. 
These inputs require little computation but constant attention. A vertical 
blank interrupt ailows the program to check for user Input every 60th of a 
second without otherwise burdening the program. It Is an Ideal solution to 
the problem of maintaining computational continuity withouT ignoring the user. 

Finally, vertical blank Interrupts allow a crude form of multiprocessing 
to take place. A foreground program can run under the vertical blank 
Interrupt while a background program runs In the mainline. As with any 
Interrupt, careful separation of the databases for the two programs must be 
maintained. However, the power obtained may well be worth the effort. 
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The ATARI Personal Computer System Is first and foremost a consumer 
computer. The hardware was designed to make this computer easy for consumers 
to use. There are many hardware features which protect the consumer from 
Inadvertent errors. Software written for this computer should reflect an 
equal concern for the uncertainties of the consumer. The consumer Is much 
more difficult to write software for than the hobbyist, but the size of the 
consumer marketplace will justify the additional effort required. The average 
consumer Is not stupid, but neither Is he familiar with the conventions and 
requirements of the computer world. Once he understands the program he will 
use It well most of the time. Sometimes the consumer will be careless. It Is 
the programmer^ responsibility to protect the naive and the careless user 
from his own mistakes as much as possible. 

The current status of consumer software human engineering Is dismal. A 
great many programs are being sold which contain very little human 
engineering. The worst offenders are written by amateur programmers, but even 
software written by professional programmers shows remarkable lapses In human 
engineering. 

Software human engineering Is a matter of organizing the Information 
flow between the user and the computer. Many programmers concentrate their 
efforts on Information flow Inside the computer. Their programs dump 
Information to the user In the form most convenient to their program, not In 
the form most convenient to the user. Their rationale seems to be that If the 
Information Is calculated correctly and displayed to the user In black and 
white then the program has done Its job. In truth, sending information Is not 
equivalent to conveying It. Displaying Information does not guarantee that 
the user understands It. The average consumer user will not be familiar with 
computer jargon. If the data Is not transmitted clearly to the user, he will 
Interpret It In his own way. Information loss In the translation Is 
Inevitable and commun I cat ion with the machine can become a time-consuming and 
frustrating experience. To maximize the effectiveness of Information 
transmission to and from the human user, the computer must translate the 
Information Into a form appropriate to the user's comprehension. Thus, the 
computer must work around the user f s needs, not the other way around. 
Information flow, whether Into the computer or out of It, must be done In a 
form which Is close to human thought patterns. Thus, the human's Involvement 
with the computer will be as direct and natural as possible. This is the 
fundamental goal of software human engineering. 

One way to cast this principle Into empirical form Is to determine the 
degree to which the human must think In order to use the software. A 
magnificently human-engineered program should require almost no cognitive 
effort on the part of the user, whiie a poorly executed product would leave 
the user staring at the screen In frustrated silence, thinking furiously. To 
minimize human processing, the program should be designed to guide the user 
through Initialization, keep him informed and attentive during execution and 
display the results clearly and concisely. When a breakdown in communication 
occurs, the computer should Initiate the correction rather than waltfng for 
the user to figure out what to do next. The more he can use the computer free 
of questions and errors, the more confident and in control he will feel. The 
challenge here Is to design software that will serve the user while placing 
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him In command of the machine. 

Certainly the most common problem with users of software Is that they 
don't understand how to make It work. The program should be designed so that 
the user will know what he needs to do next and how to direct the computer to 
do It. When possible, display critical commands on the screen on which they 
will be used. Menus and Instructions should be clear and simple so the user 
knows exactly when and where to make the entries. Related options shoul d be 
qrouped under one heading and the user guided through them rather than being 
faced with an entire screen full of choices that he may not completely 
understand. It has been shown that on the average people cannot handle more 
than seven Items at a time, so keep the Information presented to the user 
simple and give as few options at one time as possible. 

Use commands that will be familiar to the consumer. Remember that 
common programmer jargon such as "debugging", "formatting" or even "sofrware 
is meanincHess to the average consumer. Some programs will be used by The 
broad spectrum of consumers and must meet the challenge of being understood 
by all of them. Other programs by the nature of their application will be 
used only by people quite familiar with the Intricacies of a certain field of 
interest. These programs must employ the terminology of the subject mat.er. 
An accounting package that a bookkeeper might want to use would best refer to 
a list of people owing money as an "accounts receivable" list. An application 
written for musicians would use the term "minuet" or "scherzo" where a 
programmer not familiar with these terms might say "waltz-time". In both 
examples, employing the phrase that has the most meaning to the user within 
the application provides more, certainty and clarity to him when communicating 
with his machine. Command acronyms are useful in reducing keystrokes If they 
are short and meaningful so the user can learn and recall them quickly. It 
will be worth the extra time researching the appropriate vocabulary to use so 
the consumer will feel more at home when using an application program. 

The choice of language of communication between the user and the system 
Is critical also to the function of the computer. The Input language must be 
carefully selected to satisfy the needs of the user. Simultaneously, 
effective software design requires this Input language to be consistent and 
ccmolete for the purposes of the program, The software must guard against all 
possibilities of meaningless or destructive commands. When a communication 
falls, the program must be designed to correct It or effectively report It 
back to the user. 

Many techniques can be used to serve the user while safeguarding the 
software. Disable keys that have no use to the program. Set up defaults for 
frequently selected options. This protects against entering an option 
without all the prerequisites. When defaults cannot be used, provide a 
method for escaping gracefully from functions selected ouf of sequence. 
Always let the user back out to some previous point without the oss of data 
that has been input so far. If the user has typed In an unrecognized command, 
don't display a vague "Sad Entry" or "Invalid Data" error message. Highlight 
the error in the command, list the valid Input options if appropriaTe, ask 
for another try and position the cursor to the enrry point. Design forg Wing 
proar ams that will change careless mistakes automatically, such as spelling 
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errors and Inform the user when an assumption has been made so he can verify 
It. Provide a "HELP" option to give the user explanations of funtlons In more 
detail. The joystick can be used quite effectively to achieve the Ideal Input 
structure where erroneous commands are Inconceivable. 

For example, consider two programs for choosing between menu options. 
Program A asks the user to designate a choice by pressing a single key 
associated with each choice. Program B asks the user to manipulate the 
joystick to position a cursor on the option, and then press the red button to 
make the choice. Program A affords the user many opportunities for failure, 
unless every possible bad entry is masked out. Even then the user could 
still be confused and Intimidated by their existence. Program B does not give 
the user opportunities for failure. The joystick presents the user with a 
more limited set of choices. Each choice the user can make Is meaningful. 
There are no illegal entries. The user cannot even Imagine a way to fall. 

Delay times frustrate users. For example, a direct translation of 
live-action games to the computer would not be the best approach. Such sports 
as football and basketball have lengthy time-cut periods during actual play 
of the game. The same time-out delays In the computer simulation will bore 
the user. Waiting periods due to lengthy computations should also be 
minimized. In real-time processing, use the vertical blank interrupts for 
Inputting data. This frees up the mainline program to handle the 
number-crunching while the user Is thinking and entering his data. When he 
has completed, the computer then appears to "instantly" process the 
Information and Is ready for the next Input. Operating In such an Interactive 
mode, allows the user to follow the process of the program mere easily. 

When the computer Is busy, do not abandon the user. The temptation to 
bang on the keyboard occurs when It appears that nothing Is happening. When a 
delay must occur, at least display a message to Inform him, such as "ONE 
MOMENT PLEASE". Estimate how long the delay will be and display a countdown. 
With a little more creativity, some pleasant "bleeps" and "blps" can occupy 
and entertain the user. Add some simple animation and the delay time will 
seem even shorter. 

Finally, the output of results and data must be tuned to the consumer 
needs and expectations. Avoid displays that require the user to read every 
heading and entry to find his answer. Graphics and color should be used to 
associate related output so that the user can grasp the overall results at a 
glance. Organize the data display on the screen so that It Is easy to follow 
and locate information. Format the data according to the standards of the 
field. However, do not limit the display of output to the traditional form. 
For example, the use of color can enhance a standard accounts receivable 
report by highlighting the changes In status for that day. Write programs 
that will flow with the thought patterns of the user and try to stay one step 
ahead of him. For example, If a request is made for display of today's 
checxlng account balance, Include also the automatic deductions that may 
occur that day so the user does not have to ask for them. 

All too often what seems obvious to the author of a program can be 
totally obscure to the user. Ask others net Involved In the software design 
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alternating high-low beepers can be quite evocative. A sequence of sounds 
from high to low can be used to Indicate a hierarchical structure. For 
example, the structure of a large paged menu can be made more obvious If each 
page has a tone associated with It. The higher the tone, the higher that page 
resides In the structure. When using this technique, the programmer must 
adhere to the musical scale. Sequences of notes which do not follow the scale 
will grate on user's ears. 

Sounds can also be handy for occupying the user while the computer Is 
busy. The simple act of sending random notes to the speaker at Intervals 
during long computations serves the dual purpose of entertaining the waiting 
user and reassuring him that the computer Is functioning properly. Finally, 
sound can be used to provide sound effects which add to the realism and 
emotional Impact of any program. A blood-curdling scream gets the message 
across far better than any ' ERROR 17 1 message. 

The third area of sensory directness Is tactlllty. The user should be 
able to enter her Inputs In a way which Is both comfortable and emotionally 
meaningful. Keyboards have very low tactlllty. They require great dexterity 
of the user, but they do not provide the tactile response of the joystick. 
Keyboards also require that the user assume a specific position relative to 
the computer for the duration of their Interaction. Joysticks allow the user 
to sit or stand away from the computer. The most important advantage of the 
Joystick Is Its directness. To go left with a joystick one presses the stick 
to the left; what could be more direct? A similar function with the keyboard 
would require that the user repeatedly press some single key on the keyboard, 
often as fast as possible- This wears out the user's finger. It also has 
little direct relationship to the desired action. 

The real power of sensory directness comes Into Its own when It Is tied 
Into a closed I/O loop. Most programs treat Input and output with the user as 
disconnected entities. Output Is directed to the screen, and forgotten once 
It has been dumped on the user. Input Is collected from the user only as It 
Is needed. Seldom are the two tightly linked. This is a serious mistake. By 
tightly linking Input and output and making the user part of an I/O loop the 
user is woven into the fabric of the program. Information flows from the 
computer to the screen to the eye to the brain, where It Is processed. The 
response flows to the hand, to the joystick, to the computer, where it Is 
again processed. The loop Is closed. An example of such a process Is provided 
by the Russian map program. The user sees the cursor, determines where he 
wants It, and manipulates the joystick accordingly. The computer reads the 
joystick and moves the cursor In response. Interaction berween the user and 
the computer Is real-time, emotionally direct, and closed. 

In the absence of human engineering, the user is left to guess how to 
navigate the program's path. In the lowest level of human engineering, 
signposts (prompts) are placed to assist the navigation. In the next level 
of human engineering, guard rails (masks for Improper entries) are added. In 
the highest level of human engineering, failure regions are not allowed to 
exist In the program environment the user experiences. Weil-planned programs 
bring their users Into such close mental syntony with their computers that 
the user becomes unaware of the gap between himself and the computer. 
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APPENDIX III 
ATARI CASSETTE OVERVIEW 



This is a discussion of the ATARI 410" Program Recorder. The following 
topics will be included: 

1. How the cassette works - information on the hardware and software 
used to operate the cassette. 

2. Cassette applications - how to mix audio and digital information 
to produce a very user oriented program. 
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HOW 



THE CASSETTE WORKS 



1.1 RECORD STRUCTURE 
Bvte Definition: 



The OS writes files in '^^t 2 Sd^riWirit. 
bits /secand). Asynchronous serial trjnsm^aion ^ ea da 

data between the ATARI J« »nd the ATARI 41 u bU , (0=spa ce, 1=mark) , 

by te in this order, 1 s tart bit (spa c^J^yd least significant bit 
then one stop bit tmarx;. « uycc 
first. 

The fluency used to represent a mark is WJ^ • s P ace the 
frequency Is 3995 Hz . The data byte format is as follows. 

4 6 J MARK 

1 1 ~ 1 P" i , I" I 5 l _ I 7 I SPACE 



A 



s Start Bit (Space) 
0-7 = Data Bits 
B = Stop Bit (Mark) • 



Record Definition : 

~ ~ ' , & ro ,nrd is broken down in the following 

r^tr^lltlTfo "speed"/*™* t" control byte, 12B data 



0 10 10 10 1 



0 10 10 10 1 



CONTROL BYTE 



128 
DATA 
BYTES 



I 

| CHECKSUM 
I 



1st MARKER 



2nd MARKER 



(For Speed 
Measurement) 



1st and 2nd MARKER : 

. „ c ufY ) Tncludina start and stop bits, 

between the markers and the subsequent data. 
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Speed Measurement ; 

The purpose of the marker characters is to adjust the baud rate. 

The input baud rate is assumed to be a nominal 600 baud. This is 
adjusted, however, by the SIO routine to account for drive motor variations 
stretched tape, etc. Once the true receive baud rate is calculated, the 
hardware is adjusted accordingly. Input baud rates ranging from 318 to 
1407 baud can theoretically be handled using this technique. 

The OS checks the tape speed in the following manner: The software 
looks at the POKEY Serial-In bit continuously. Looking for a start (0 
bit) which signifies the beginning of a record. When it finds one, the 
OS stores the current frame counter by saving the ANTIC VCOUNT (vertical 
screen counter). Continuing to look directly at the Serial-In bit, the 
OS counts the twenty bits (end of the 2 markers), then uses VCOUNT and the 
frame counter to determine the elapsed time. The baud rate to use is 
derived from the result. This is done for each record. 



Control Bvte: 

The control byte contains one of three values: 

SFC indicates the record is a full data record (128 bytes). 

$FA indicates the record is a partially full data record; fewer 
than 128 bytes were supplied by the user. This case may occur only 
in the record prior to the end-of-file. The actual number of data 
bytes, 1 to 127, is stored in the last data byte prior to the 
checksum; i.e. the 128th data byte. 

$FE indicates the record is an end-of-file record and is followed by 
128 zero bytes. 



Checksum : 

The checksum is generated and checked by the SIO routine, but is not 
contained in the cassette handler's I/O buffer CASBUF [03FD]. 

The checksum is a single byte sum of all the other bytes in the 
record, including the two markers. The checksum is computed with end- 
around carry. As each byte is added into the sum, the carry bit is also 
added in. 

Partial Sum 
+ Dat3 Byte 
+ Carry 

Result 
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1.2 TIMING 

1.2.1 INTER-RECORD GAP (IRG) 

As was mentioned in section 1.1 each record consists of 132 data 
bytes including the checksum byte. In order to distinguish one record 
from another, the cassette handler adds a Pre-Record Write Tone (PRWT) and 
Post-Record Gap (PRG). PRWT and PRG are both pure mark tone. The Inter- 
Record Gap (IRG) between any two records thus consists of the PRG of the 
first record followed by the PRWT of the second record. The layout of 
the records and gaps is as follows: 

I PRWT I MARKER I DATA I PRG I PRWT I MARKER I DATA I PRG I 

RECORD 1 l RECORD 2 



1.2.2 NORMAL IRG MODE & SHORT IRG MODE 

The length of PRWT and PRG are dependent upon the Write Open mode. 
There are 2 types of IRG modes: Normal IRG mode and Short IRG mode. 

When a file is opened the most significant bit of AUX2 specifies the 
mode. On subsequent output or input, the cassette handler executes the 
READ/WRITE in either mode based on the MSB of the AUX2 byte: 



AUX2 
C 

c 



nrr 



i i i 



1 indicates that the cassette is to be read/written in Short 
IRG mode. (Continuous mode) 
0 indicates Normal IRG mode. 



Normal IRG Mode: 



This mode is used for a READ interleaved with processing; i.e. the 
tape always comes to a stop after each record is read. If the computer 
"STOPS" the tape and gets its processing done fast enough, the next READ 
may occur so quickly that the cassette deck may see only a slight dip in 
the control line. 



Short IRG Mode : 

In this mode the tape is not stopped between records, either when 
being written or during readback. 

On readback, the program must issue a READ for each record before it 
passes the read head. The only common use of this mode so far is storage 
of BASIC programs in internal (tokenized) form where, on readback, BASIC 
has nothing more to do with the data than put it in RAM. The special 
BASIC commands "CSAVE" and "CLOAD" specify this mode. 
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There can be a potential problem with this. The software that writes 
the tape must allow long enough gaps, so the beginning of records are not 
missed on readback. 

1.2.3 TIMING STRUCTURE 

The timings for each of the inter-record gaps are as follows: 

NORMAL IRG PRWT = 3 seconds of mark tone. 
SHORT IRG PRWT = 0.25 seconds of mark tone. 

NORMAL IRG PRG s Up to 1 second of unknown tones. 
SHORT IRG PRG s From 0 to N seconds of unknown tones, where N 

is dependent upon user program timing. 

Each record is written with the following timing: once the motor 
starts and the Pre-Reccrd Write Tone (PRWT) is written, the duration of 
the tone depends on the above format. The record follows, then the 
Post-Write Gap (PRG) is written. The motor is then stopped for Normal 
mode, but continues writing mark for Short IRG mode. 

Note that for the Normal IRG mode, the tape will contain a section of 
unknown data because of stopping and restarting the motor. (Up to 1 second 
of travel is possible, depending on the cassette machine.) This unknown 
data may be garbage data left previously on the tape. 



1.2.4 NOISY I/O FEATURE 

The Noisy I/O feature is useful for determining the success of 

reading the tape, particularly with CLOAD. Marks and spaces use different 

sound frequencies and one quickly learns the good and bad sounds the OS 
makes. 



1.3 FILE STRUCTURE 

A file consists of the following three elements: 

1 ) A 20 second leader of the mark tone. 

2) Any number of data records. 

3) End-Of-File. 

When the file is opened (output), the OS starts by writing a mark 
leader of 20 seconds, the OS then returns to the caller, but leaves the 
tape running and writing marks. 

The WRITE/READ timeout counter is set for about 35 seconds as the OS 
returns. If the timeout occurs before the first record is written, the 
tape will stop, leaving a gap between the open leader and the first record 
leader. 
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1.4 TAPE STRUCTURE 

There are 2 sides to each tape. Each side has 2 tracks, one for 
audio and the other one for digital recording. This way the tape can be 
recorded in both directions. Following is a flat view of the tape: 



////////AUDIO TRACK//////// LEFT TRACK 

SIDE 

A 

////////DIGITAL TRACK//////// RIGHT TRACK 



////////DIGITAL TRACK//////// RIGHT TRACK 

SIDE 

8 

////////AUDIO TRACK//////// LEFT TRACK 



Tapes are recorded in 1/4 track stereo format at 1 7/8 inches per 
second (IPS). Note that the Atari 800 utilizes a tape deck that has a 
stereo head configuration (not a single or mono type). 



1.5 CASSETTE SOOT 

The Cassette Boot program can be booted from the cassette at power up 
time as part of the system initialization. 

System initialization performs functions such as zeroing all of the 
hardware registers/ clearing RAM, setting flags and so on. 

After all the resident handlers are brought in, if the * START 1 key is 
pressed, the Cassette Boot request flag CKEY [004A] is set. If the 
Cassette Boot request flag is set, then a Cassette Boot operation is 
attempted. 

The following requirements must be met in order to boot from the 
cassette: 

1) The operator must press the ' START 1 key as power is applied to the 
system . 

2) A cassette tape with a proper boot format file must be installed 
in the cassette drive, and the 'PLAY' button on the recorder must 
be pressed. 
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3) The cassette file must have been created in Short IRG mode. 



4) When the audio prompt occurs, the operator must press a key on the 
keyboard. 

If all of these conditions are met, the OS will READ the boot file 
from the cassette and then transfer control to the software that was read 
in. The Cassette Boot process is given in more detail below. 



1) READ the first 




record to the cassette buffer. 



2) Extract information from the first 6 bytes. The first 6 bytes of 
a Cassette Boot file are formatted as shown below: 



IGNORED 



1st BYTE 



# OF RECORDS 



MEMORY ADDRESS I LO 

I 
I 

TO START LOAD I HI 

I 

I 

I LO 



INIT 



ADDRESS 



i HI 
I 



6th BYTE 



1ST BYTE: is not used by the Cassette Boot process. 

2ND BYTE: contains the number of 128 byte cassette records to be 
read as part of the boot process (including the record containing 
this information). This number may range from 1 to 255, with 0 
meaning 256. 

3RD and 4TH BYTES: contain the address (L0,HI) at which to start 
loading the first byte of the file. 

5TH and 6TH BYTES: contain the address (L0,HI) to which control 
is transferred after the boot process is complete. Pressing the 
[S/RESET] key will also transfer control to this address assuming 
that the boot process is complete. 

When step 2 is complete, the Cassette Boot program will have: 

A) saved # of records to boot. 

B) saved the load address. 

C) saved the initialization address in CASINI [02,03]. 
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3) Move the record just read to the load address specified. 

4) READ the remaining records directly to the load area. 

5) 3SR to the load address +6 where a multi-stage boot process may 
continue. The carry bit will indicate the success of the operation 

(carry set = error, carry reset = success) on return. 

6) JSR indirectly through CASINI for initialization of the application. 
The application should put its starting address into DOSVEC [OA, OB] 
during initialization, and then return. 

7) OMP indirectly through DOSVEC to transfer control to the application. 

Pressing the [S/RESET] key after the application is fully booted will 
cause steps 6 and 7 to be repeated. 



III-8 



ATARI CASSETTE 



CASSETTE APPLICATIONS 

This section covers how to utilize the Atari cassette system, 
2.1 HOW TO CONFIGURE THE CASSETTE SYSTEM 

Most serial bus devices have two identical connectors: one is a 
serial bus input and the other a serial bus extender. Using these connec- 
tors peripherals may be "Daisy Chained 11 simply be cabling them together in 
a sequential fashion like the following diagram: 

1 T.V. 1 

H 

I 

I ! i I i I 

I I II II 



I 800 I I DISK | | DISK I I 410 I 

I I I DRIVE I | DRIVE I I I 

I I I I 

However, the cassette does not conform to the protocol of the other 
peripherals that use the serial bus. The cassette must be the last device 
on the serial bus because it does not have a serial bus extender connector 
as the other peripherals do. The lack of a bus extender assures that 
there is never more than one cassette drive connected to the system. The 
system cannot sense the absence or presence of the cassette drive, so it 
may be connected and disconnected at will. 

Whenever there is a need to open a cassette file for reading or 
writing, the user will have to follow the following instructions: 

INPUT (DATA FROM 410 TO 800): When the cassette is opened for input, 
a single audible tone is generated using the keyboard speaker. If 
the cassette is ready (power on, serial bus cable connected, tape 
cued to start of file), the user must depress the 1 PLAY ' button on 
the cassette and any 800 keyboard key (except [BREAK] ) to initiate 
tape reading. 

OUTPUT (DATA FROM 800 TO 410): When the cassette is opened for 
output, two separate 3udible tones are generated using the keyboard 
speaker. If the cassette is ready (as previously described), the 
user must simultaneously press the ' PLAY 1 and 'RECORD' buttons on the 
cassette, and then press any keyboard key (except [BREAK]) to initiate 
writing the tape. 



SERIAL 
BUS 
CONNECTOR 
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2.2 SAVING AND LOADING DIGITAL PROGRAMS 
Concept ; 

The following technique saves the digital data directly from the 
computer through its I/O port of either the 410 or the Atari Lab Machine 
which uses 1/4 inch tape recorded at 7 1/2 inches per second. 

FOR BASIC: 

FORMAT: CSAVE 

100 CSAVE 

This command is usually used in direct mode to save a 
RAM-resident program onto cassette tape, 'CSAVE' writes 
the tokenized version of the program to the 410. 

FDRMAT: CLOAD 

1QQ CLOAD 

This command can be used in either direct or deferred mode 
to read programs from cassette tape into RAM for execution. 



FOR ASSEMBLY LANGUAGE: 

SOURCE PROGRAM 

FORMAT: LIST//C: [ ,XX, YY] 

This command is used to write assembly source code. The 
items in the optional brackets [,XX,YY] mean to transfer 
only lines XX to YY to cassette. If line numbers are not 
provided the whole program is listed to cassette. 

FORMAT: ENTERIC: 

This command reads source code from the cassette. 

OBJECT PROGRAM 

FORMAT : SAVE#C :< XXXX , YYYY 

The contents of a block of memory, locations XXXX to YYYY, 
is saved onto cassette. 

FORMAT: L0AD#C: 

This command will load memory with the material that was 

previously saved. The range of memory locations that are 

filled will be the same as those given in the original save 
command. 



111-10 



ATARI CASSETTE 



2.3 SAVING DIGITAL PROGRAMS WITH AUDIO AS BACKGROUND 
Concept : 

This recording technique does not allow any program control over the - 
audio. The audio plays purely as background to help time pass during the 
monotonous loading process. 

Follow the digital writing instructions indicated in 2.2 
for BASIC and Assembly programs; except, this time ATARI 
standard cassette tape (1 7/8 inches per second) is not 
used. Because it is hard later for an individual to record 
audio onto 410, we have to use the ATARI recording lab 
machine, which uses 7 1/2 inches per second master tape. 
The lab machine is a much more sophisticated recording 
machine able to record data onto a specified track. 

On the lab machine, the recording mode is switched to "ON" 
for the right track, so digital is saved onto the right 
track of the 7 1/2 inch tape. 

Do STEP 1 for audio recording, except first rewind the tape 
to the beginning of the program then switch the recording 
mode to "ON" for left track. This way the audio is recorded 
onto the left track of the 7 1/2 inch tape. 



2.4 DIGITAL PROGRAMS, AUDIO, SYNC MARK, AND SCREEN MANAGEMENT 

Sync Mark Conceot: 

There is no efficient way for the program to detect an audio segment 
when the cassette is playing. In. order to solve the synchronization 
problem, Sync Mark is used to carry the signal to inform the program that 
an audio segment has been played (an audio segment can be either a piece 
of music or an instruction, depending on the application). 

More precisely, since audio dat3 has no record structure, Sync Mark 
recorded on the digital track is more or less like End-Of-Record Mark for 
audio. For example, once the program senses the Sync Mark, the program 
can decide what to do next like stop the cassette motor for lengthy 
processing, or continue to play the next audio segment. 

STEP 1: The programmer figures out an audio script for "FROG". The 

script is like this: 

(MUSIC) TODAY I AM GOING TO TELL YOU A FAIRY-TALE NAMED 
"THE PRINCESS AND THE FROG". IT IS A SWEET STORY SO DON f T 
GO AWAY. / 

(MUSIC) BEFORE I START MY STORY, I WOULD LIKE TO KNOW WHO 
I AM TALKING TO. WAT IS YOUR NAME? TYPE YOUR NAME AND 
HIT CARRIAGE RETURN. (PAUSE) 



STEP 1: 



STEP 2: 
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(MUSIC) NOW, LET'S START THE STORY . ONCE UPON A TIME, 
THERE WAS THIS BEAUTIFUL PRINCESS LIVING IN A CASTLE AND 
HER NAME WAS YYYY. / 

(MUSIC) ON A CLEAR AND BEAUTIFUL DAY, THE PRINCESS WAS 
WALKING ALONG THE / 

REMARK : 

- means the program is checking for a sync mark. 
It is best if the speaker pause about 1/2 second here 
before continuing to the next segment of the audio 
script. 

- "PAUSE" is to indicate that the speaker pauses about 
1 second here to allow time for the stopping and 
starting of the cassette motor.. Each audio segment 
should be at least 10 to 30 seconds long, because too 
many closely spaced Sync Marks can confuse the computer. 

STEP 2: It is suggested that before coding begins, the programmer 

draft a general plan for the program indicating the rela- 
tionship between screen (CPU) and audio. 

EXAMPLE: The following example (see page II 1—1 3) illustrates 
how a programmer should create a cassette containing a 
program which has control over an audio track. The example 
is called "FROG" : 

STEP 3: The programmer can start coding the program called 

"FROG", and it will look something like this: 

10 REM PROGRAM "FROG" TO DEMONSTRATE SYNCHRONIZATION 
20 REM OF AUDIO WITH DIGITAL FOR THE CASSETTE SYSTEM 
30 REM 

AO DIM IN$(20) 

50 POKE 5401 8, 52: REM TURN ON MOTOR 
60 GRAPHICS 1 

70 PRINT #6; "THE PRINCESS AND THE FROG" :PRINT #6; :REM 

SET UP THE SCREEN FOR EVENT 2. 
80 GOSUB 1000: REM CHECK SYNC MARK, MAKE SURE THE INTRODUCTION 

IS SAID. 

100 POSITION X,Y:PRINT #6;"Y0UR NAME?" : REM FOR EVENT 4 
105 GOSUB 1000: REM EVENT 5 

110 POKE 5401 8, 60: REM STOP MOTOR FOR USER INPUT 
120 INPUT INS: REM WAIT FOR THE USER'S NAME 
130 POKE 54018,52 

135 PRINT #6 , CHR$( 1 25 ) : REM CLEAR THE SCREEN 

140 POSITION X,Y:PRINT #6;IN$:PRINT IP6; :REM DISPLAY 

SCREEN FOR EVENT 10 
150 GODUB 1000:REM MAKE SURE SPEECH FOR EVENT 10 IS FINISHED 
160 PRINT #6; :REM READY FOR EVENT 12 
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"FROG" 




'TODAY I AM' 
' GOING TO..' 




I I 
I 



THE PRINCESS 
& THE FROG 



I 

I GRAPHIC 



YES 



! BEFORE I ' I | 



I THE PRINCESS 
I 4 THE FROG 
I GRAPHIC 
I YOUR NAME7XXXX 



5 


1 1 YES ' 1 


6 


1 1 i 

1 1 STOP 


7 1 

! 


1 1 

1 WAIT TILL AN 
1 INPUT IS 
1 RECOGNIZED 


i 
1 

1. 


1 
1 

1 


s 


1 
1 




START 


i i 

9 1 I CLEAR THE SCREEN 






1 1 
10 | 1 NOW LET'S ' | ! || 

1 1 1 xxxx I 

1 pp^pUTp 

i 1 ui <nr i i i w 


1 
1 
1 




1 i 
11 ! 1 


YES 




1 1 







! 
I 

I 12 I 'ON A CLEAR.. 1 I | 

I 



I I 



! 


I 


1 GRAPHIC 


1 1 


1 


i 


1 




1 


1 



I 

I 13 
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ROUTINE TO CHECK SYNC MARK: On the tape, non-sync is 
represented by "MARK" and Sync Mark is represented by 
"SPACE". (Space is a "0" frequency, it is a lower pitch 
sound than a Mark which is a "1" frequency. As mentioned 
before, Mark frequency is 5327 Hz, Space is 3995 Hz). The 
Check Sync Mark routine continuously watches for a "SPACE" 
from the serial port. The routine looks like this: 

1000 IF INT(PEEK(53775)/32+0.5)=INT(PEEK(53775)/32) 
THEN RETURN: REM CHECK THE 5TH BIT OF EACH 

INCOMING BYTE. IF IT IS "0"THEN 
THE SYNC SPACE IS FOUND. 

1010 GOTO 1000 

ROUTINE TO CONTROL THE MOTOR: The program can turn the 
cassette motor on and off by poking location 54018 with the 
data given below: 

ON: POKE 54018,52 
OFF: POKE 54018,60 

STEP 4: After the audio script has been roughly written, the 

programmer should estimate the time and the tape length 
required for the designed audio script (including pauses) 
and program. If the tape length required is too long for 
one cassette, then either the script or the program will 
have to be modified to fit into one cassette. 

STEP 5: Save the program to a master tape, far example "MASTER 1". 

STEP 6: With the audio script the voice is taped with pauses on 

another master tape, "MASTER 2". 

STEP 7: After "MASTER 1" and "MASTER 2" are produced, these 2 

master tapes are merged to produce another master tape 
called "MASTER 3". "MASTER 3" has the program recorded 
first, and the audio spliced on the end. Three recording 
lab machines are needed for this procedure. Make 2 copies 
of "MASTER 3". 

STEP 8: Load the Sync Mark program into the Atari 800. The 

purpose of this program is to write continuous Sync Mark 
("0" frequency) onto the digital track. The Sync Mark 
informs the program that an audio segment has been played. 
Whenever there is a pause indicated on the audio script, 
a Sync Mark is needed at that place. The finisned tape 
with audio and sync would be as follows: 
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TODAY. I AM... BEFORE I... NOW LET'S... 

'}}///}/////] | ////////////////// V ' ' '})//////}/ 'audio 



SIDE I 
A • AUDIO SEGMENT 

I//I DIGITAL 



SYNC MARK 



SIDE 

B . ^ ^ TAPE MOTION 



The Sync Mark program looks like this: 

10 REM PUSH "START" CONSOL KEY TO 
20 REM ADD THE SYNC MARK ONTO THE TAPE 
30 REM 
40 REM 

50 10=53760 : C0NS0LE=53279 : CASS=54018 
100 FOR 1=0 TO 8 
110 READ J : POKE 10+1,0 
120 NEXT I 

125 REM THE FOR LOOP SETS THE AUDIO FREQUENCY i CHANNEL 
130 DATA 5,160,7,160,5,160,7,160,0 
140 REM 

150 REM I/O IS SETUP; NOW START THE CASSETTE 
160 POKE CASS, 52 
200 POKE CONSOLE, 8 

210 IF PEEK (CONSOLE) <> 7 THEN 230:REM C0NS0LE=7 MEANS WRITE 
MARK, 

220 POKE 10+15,11: GOTO 200: REM CONSOLER KEYS NOT PRESSED 
230 POKE 10+15,128+11: GOTO 200: REM IF CONSOLE <> 7 WRITE 
"SPACE" 

STEP 9: Mount both "MASTER 3" tapes in two independent recording 

machines and rewind both tapes to the splice of program and 
audio. Configure one recording machine to one Atari 800 
with Sync Mark program loaded. This recording machine is 
prepared for recording Sync Mark on the digital track. The 
other recording machine will play back the audio recorded 
earlier. 

STEP 10: Type "RUN" to start the Sync Mark program. At the same 

time start the recording machines, one for recording, 
another one for playback. Listen to the audio and hit the 
"START" key whenever it is indicated by a pause in the 
audio script. 
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.<t-K i-ho nrnaram recorded followed by 
ready for mass production. 

2.5 DISABLING THE BREAK KEY • 

... fKo nrnnra m mer disable the BREAK key. This 

this: 

4000 X= PEEKC16): IF X 128 THEN 4020 
4010 POKE 16,X-128: POKE 53774, X-128 
4020 RETURN 

The disable routine should be called whenever there is a change of 
graphics mode or any screen open call. 



2.6 MASS PRODUCTION 

The programmer produces one or more "MASTER TAPES- according t« J the 
recording techniques discussed in ^^^fo^^l^o^ at 7 

as a "SOURCE MASTER". 

The duolicator will take the "SOURCE MASTER" to make a "WORK MASTER" 
Tne dupiicatuu waa* th* released Droduct will be 

for the final cassette mass proouction. The "leased pr 

third generation from the original. The following 

process: 



A / UN / tmtc"RTM^ f WORK I MASS PRODUCTION 

T ( SOURCE INTERIM I WORK CASSETTES 

H ^MASTERy ^MASTER J \___V 



A— 

R 
I 



"INTERIM MASTER" is 

™" needt The INTERIM MASTER" U tne 
backup copy for the "WORK MASTER". 




, T . OT n „ f .„ w hp wotn LOOP" method for mass production. 

At present, ATARI prefers the b.,N Luur r LQOp MASTER 

ifwriov m a cfrpti i S rooied to produce a "LOOP MAbitK . ine uuur 

: 1A" R 1/2", C c? any Up. --dth. ifu lac n 

The configuration is like this: 
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MASTER MACHINE 



SLAVE MACHINES 



READ - 
HEAD 



I I 

10 0 1 

— [] I 

I I 



I I 
10 0 1 

I I 



! 



! 



10 0| 

I [] I 

I I 



I I 

10 0 1 

=1 [] I 



i r 



I I' 



LOOP MASTER 



The "LOOP MASTER" is repeatedly read. If the duplicator wants to 
produce 100 cassettes, for example, the length of the tape on the "SLAVE 
MACHINE" is measured to the length of the program multiplied by 100. 
There is a counter on the "MASTER" machine and it is set to 100. 

As the "LOOP MASTER" is continuously read, the data (all four tracks) 
is copied onto the "SLAVE MACHINE" tape. 

As the clear section in the LOOP MASTER is sensed, the "MASTER" 
machine produces a "CUTTING TONE" which is recorded on one or more tracks 
on the SLAVE MACHINE tapes. The counter will then increase by one. 

Each finished tape from the "SLAVE MACHINE" has 100 recorded programs 
with 100 CUTTING TONES recorded. It is fed into an automatic loading 
machine which winds the tape into C-Zero cassette shells. The configuration 
is like this: 



LOADER 



TAPE FROM 
SLAVE MACHINE 




I 
I 

— CASSETTE TAPE HUBS 
— CASSETTE SHELL 

I 

! 
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The cassette shells come with a small loop of leader which is bound 
to the cassette tape hubs. The loader pulls the leader from the shell, 
cuts it, and splices the end of the slave machine tape to the leader. The 
tape hub is used to wind the tape into the shell until the cutting tone is 
sensed. The slave machine tape is then cut and spliced to the leader on 
the other hub. 

The cassette shell is removed either manually or mechanically from 
the loader and the tape in the cassette shell is fully wound. The next 
cassette shell is loaded by the same process. 

2.6.2 QC TESTING 

Any time that a production run is created, samples must be taken from 
it and verified before it is approved and released. 

The QC testing is done normally by taking the first and the last 
cassette produced. Atari must receive at least 10 samples from each 
mass production for each master released. 
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TELEVISION ARTIFACTS 



This section discusses how to get multiple colors out of a single 
color graphics mode through the use of television artifacts. 

The ANTIC modes with which this can be accomplished are 2,3, and 15 
ANTIC mode 2 corresponds to BASIC mode 0, ANTIC mode 15 is BASIC mode 8, 
and ANTIC mode 3 has no corresponding BASIC mode. Each of these modes has 
a pixel resolution of one half color clock by one scan line. They are 
generally considered to have one color and two luminances. With the use 
of artifacts, pixels of four different colors can be displayed on the 
screen in each of these modes. 

The term TV artifacts refers to a spot or "pixel" on the screen that 
displays a different color than the one assigned to it. 

A simple example of artifacts using the ATARI computer is shown by 
entering the following lines: 

GRAPHICS 8 
COLOR 1 
POKE 710,0 
PLOT 60,60 
PLOT 63,60 

These statements will plot two points on a black background, however 
each pixel will have a different color. 

To understand the cause of these differing colors one must first 
understand that all the display information for the TV display is contained 
in a modulated TV signal. 

The two major components of this signal are the luminance, or bright- 
ness, and the color, or tint. The luminance information is the primary 
signal, containing not only the brightness data but also the horizontal 
and vertical syncs and blanks. The color signal contains the color 
information and is combined or modulated into the luminance waveform. 

The luminance of a pixel on the screen is directly dependent on the 
amplitude of the luminance signal at that point. The higher the amplitude 
of the signal, the brighter the pixel. 

The color information, however, is a phase shifted signal. A phase 
shifted signal is a constantly oscillating waveform that has been delayed 
by some amount of time relative to a reference signal, and this time delay 
is translated into the color. 

The color signal oscillates at a constant rate of about 3.579 MHz, 
thus defining the highest horizontal color resolution of a TV set. This 
appears on the screen in the form of 160 visible color cycles across one 
scan line. (There are actually 223 color cycles including the horizontal 
blank and sync, and any overscan.) 
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The term "color clock'* refers to one color cycle and is the term 
generally used throughout the ATARI documentation to describe units of 
measurement across the screen. The graphics mode 7 is an example of one 
color clock resolution, where each color clock pixel can be a different 
color. (There are microprocessor limitations though.) 

ATARI also offers a "high resolution" mode (GRAPHICS 8) that displays 
320 pixels across one line. This is generated by varying the amplitude of 
the luminance signal at about 7.16 MHz, which is twice the color frequency. 

Since the two signals are theoretically independent, one should be 
able to assign a "background" color to be displayed and then merely vary 
the luminance on a pixel by pixel basis. This in fact is the way mode 3 
works, the "background" color coming from play field register 2, and the 
luminances coming from both playfield registers 1 and 2# 

The problem is that in practice the color and lumincance signals are 
not independent. They are part of a modulated signal that must be demodu- 
lated to be used. Since the luminance is the primary signal, whenever it 
changes, it also forces a change in the color phase shift. For one or 
more color clocks of constant luminance this is no problem, since the color 
phase shift will be unchanged in this area. However, if the luminance 
changes on a half color clock boundary it will force a fast color shift at 
that point. Moreover, that color cannot be altered from the transmitting 
end of the signal (the ATARI computer). 

Since the luminance can change on half color clock boundaries, this 
implies that two false color, or artifact pixel types can be generated. 
This is basically true. However, these two pixels can be combined to form 
two types of full color clock pixels. This is illustrated below: 

TV Scan Line l 1 color I I 

I clock j | 
k 1 J I I I 

IpKitl I I ! 



Luminance 
0=off 
1=cn 



I 



0 


1 


I 


0 


I 0 


1 


0 


I 


0 


I 0 


1 


1 


i 


0 


0 


o T 1 


I 


1 


I o 



I 



1/2 cc pixel color A 
1/2 cc pixel color B 
1 cc pixel color C 
1 cc pixel color 0 



(Note that each of these pixels requires one color clock of distance 
and therefore has a horizontal resolution of 160. 

The colors A through D are different for each TV set, usually because 
the tint knob settings vary. Thus they cannot be described as aosolute 
colors, for example red; but they are definitely distinct from each other, 
and programs have been written that utilize these colors. 
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To illustrate a simple application of artifacting, refer to the 
example below. This program draws lines in each of the four artifact 
colors and then fills in areas using three of the colors. (Note that 
displaying many pixels of either type C or D next to eacn other results in 
the same thing: a line or constant luminance with background color.) 

The POKE 87,7 command causes the OS to treat this mode as mode 7 and 
to use two-bit masks when setting bits in the display memory. To generate 
color A, use COLOR 1, color B uses COLOR 2, and color C uses COLOR 3. 
Color D is generated by displaying COLOR 1 to the left of COLOR 2. 



10 GRAPHICS 8:P0KE 87,7:P0KE 710,0:P0KE 709,14 

20 COLOR 1:PL0T 10,5:DRAWT0 10,70 

30 PLOT 4G,5:DRAWT0 40,70 

40 COLOR 2 :PL0T 20,5:DRAWT0 20,70 

50 PLOT 41 ,5:DRAWT0 41 ,70 

60 COLOR 3: PLOT 30,5:DRAWT0 30,70 

70 FOR X=1 TO 3: COLOR X:P0KE 765, X 

80 PLOT X*25+60,5:DRAWT0 X*25+60,70 

90 DRAWT0 X*25+40,70:POSITIQN X*25+40,5 

100 XI0 18, #6, 12,0, "S:" 

110 NEXT X 



IV-3 



APPENDIX V FLOATING POINT ROUTINE EXAMPLE 



OCOO 
DDB6 
DA60 
0482 
DDA7 
D8E6 
00F3 
D800 
00F2 
0580 

009B 
0009 
0005 
E456 
0342 
0344 
0348 



20 

30 FMOYE 
40 FSUB 
50 FTEMP 
60 FSTOR 
70 FASC 
80 INBUFF 
85 AFP 
90 CIX 
0100 LBUFF 
0110 ; 
0120 CR 
0130 PUTREC 
0140 GETREC 
0150 CIOV 
0160 ICCOM 
0170 ICEAL 
0180 IC8LL 
0190 ; 
0200 ! 



*= $4000 

$DDB6 
$DA60 
$0482 
$D0A7 
$D8E6 
$00F3 
$D800 
$00F2 
$0580 



;ARB ITRARY STARTING POINT 



0210 



0220 



$9B 
$09 
$05 

$E456 
$0342 
$0344 
» $0348 
WRITTEN BY CAROL SHAW 

FLOATING POINT (F.P.) ROUTINE DEMO PROGRAM. 
READS TWO NUMBERS FROM SCREEN EDITOR, 
CONVERTS THEM TO FLOATING POINT. 
SUBTRACTS THE FIRST FROM THE SECOND, 
STORES THE RESULT IN FTEMP (USER- 







0230 


; DEF I f 1 


JED F.P. REGI 


STER), AND DISPLAYS THE RESULT. 






0240 


• 




• 








0250 


START 








4000 


205340 


0260 




JSR 


GETNUM 


;GET 1ST NUMBER FROM E: 
AND CONVERT TO F.P. 


4003 


20B6DD 


0270 




JSR 


FMOVE 


;M0VE NUMBER FROM FRO TO FR1 


4006 


205340 


0280 




JSR 


GETNUM 


;GET 2ND NUMBER FROM E: 
— OMIT IF ONLY ONE ARGUMENT 


4009 


206CDA 


0290 




JSR 


FSUB 


;FRO <— FRO - FR1 
CHANGE TO GET DIFFERENT ROUT 


400C 


900A 


0300 
0310 


• 

9 


BCC 


NOERR 


;SKIP IF NO ERROR 






0320 


; ERROR — 


D 1 SPLAY 


MESSAGE 






0330 


; 








400E 


A981 


0340 




LDA 


*ERRMSG4255 


4010 


8D4403 


0350 




STA 


ICBAL 




4013 


A940 


0360 




LDA 


#ERRM3G/256 


4015 


4C3940 


0370 
0380 


NO ERR 


J MP 


C0NT1N 




4018 


A282 


0390 




LDX 


#FTEMP&255 ;ST0RE RESULT IN 














FTEMP (USER'S F.P. VAR) 


401 A 


A004 


0400 




LDY 


#FTEMP/256 


401 C 


20A7DD 


0410 




JSR 


FSTOR 
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40 IF 20E6D8 
4022 AOFF 

4024 C8 

4025 81 F3 



0420 
0430 
0440 

0450 
0460 



rnNVPRT NUMBER TO ASCII STRING. 

! f?nd end of string and change negative # TO 

' POSITIVE AND ADD CARRIAGE RETURN. 

; CON VERT FROM F.P. TO 
ASCII STRING IN LBUFF 



0470 

0480 MLCOP 

0490 

C500 



JSR FASC 
LDY #SFF 



4027 
4029 
402B 
402D 
402E 
4030 



10FB 
297F 
91 F3 
C8 

A99B 
91 F3 



STA ( 1 NBUFF) ,Y 
DISPLAY RESULT 



4032 A5F3 
4034 8D4403 
4037 A5F4 



4039 

403C 

403E 

4041 

4043 

4046 

4048 

40 4B 

40 4D 

4050 



8D4503 
A909 
8D4203 
A928 
8D4803 

A900 
8D4903 
A200 
2056E4 

4C0040 



0510 
0520 
0530 
0540 
0550 
0560 
0570 
0580 
0590 ; 
0600 
0610 
0620 

0630 C0NT1N 
0640 
0650 
066U 
0670 
0680 
0690 
0700 
0710 
0720 
0730 



I NY 

LD A ONBUFFl.Y .UBWr™ 

dpi MLOOP ;YES. CONTINUE 

AND «7F JNO. NEGATIVE - MASK OFF MSB IT 

STA (I NBUFF) ,Y 

; STORE CARRIAGE RETURN 



I NY 

LDA #CR 



LDA 


I NBUFF 


STA 


ICSAL 


LDA 


1 NBUFF+1 


STA 


1CBAL+1 


LDA 


#PUTREC 


STA 


ICCOM 


LDA 


#40 


STA 


tCSLL 


LDA 


#0 


STA 


IC8LL+1 


LDX 


#0 


JSR 


CIOV 


J MP 


START 



; BUFFER ADDRESS IS IN I NBUFF 



•COMMAND IS PUT RECORD 
; BUFFER LENGTH = 40 



IOCS # ■ 0 (SCREEN EDITOR) 

CALL CIO 
DO IT AGAIN 
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0740 ; 

• 0750 ; GETNUM — GET ASCI I STRING FROM E: AND 

CONVERT TO F.P. IN FRO 







0760 


• 
9 




« 








0770 

w / / w 


GFTNUM 










A905 


0780 

W / WW 




L DA 


iGETREC 


•GET RECORD (ENDS IN CR) 

p W W 1 f \JW WW! \W \ LI lUw 111 WIN/ 






w / ¥ w 




^TA 

W i A 






4058 


A980 


0800 




LDA 


/LBUFF&255 


; BUFFER ADDRESS = LBUFF 




804403 


081 0 

VW t w 




STA 

w l #v 


ICBAL 




405D 


A905 


0820 

W W^_ w 




LDA 


i\ RUFF/256 




405F 


8D4503 


0830 

w w w w 




STA 






4062 


A^28 


0840 

W w*t W 




LDA 


#40 

jT *TW 


•BUFFER LENGTH ■ 0 

f W Wl 1 «-w \ W Wi ' W 111 W 


4064 

■f WW ** 


8D4.fi 03 

WW TO VJ 


0850 

w (J J \J 




STA 

w » r\ 


ICSLL 




4067 

*TWW / 


A900 


0860 

w \J w w 




LDA 


#o 

r w 




4069 


8D4SG3 

W W *T 9 W 


0870 

W W / w 




STA 

W 1 / » 


1C3LL+1 




4C6C 


A200 


0880 

v w w w 




LDX 


£0 

3r w 


♦IOCS i = 0 (SCREEN EDITOR) 

j J www Jr w V %wi\i.«n ww 1 1 wf \ / 


406E 


2056E4 


0890 

w w ^ w 






CI ov 


•CALL CIO 


4071 


A980 


0900 

w -? wU 




LDA 

• 


/LBUFF&255 


; STORE BUFFER ADDRESS 
IN POINTER (INBUFF) 


4073 


85F3 


091 0 




STA 


I NEUFF 




4075 


A905 


0920 




LDA 


#L3UFF/256 




4077 


85F4 


09^0 

W -/ — ' w 




STA 


1 NBUFF+1 




4079 


A900 


0940 




LDA 


#0 


; BUFFER INDEX = 0 


407B 


85F2 


0950 




STA 


CIX 




407D 


4C00D8 


0Q£fi 




JMP 


AFP 


;CALL ASCII TO FLOATING POINT 


RETURN 












4080 


60 


0C70 

W / w 


1 N IT 


RTS 




; POWER UP ROUTINE (DO NOTHING) 


4081 


45 


0980 




.BYTE " ERROR", CR INDICATES CARRY SET 














ON RETURN FROM FP ROUTINE 


4082 


52 












4083 


52 












4084 


4F 












4085 


52 












4086 


9B 


0990 


• 












1000 


; R0UT1 


NE START INFO 








1010 


• 








4087 




1020 




*= 


S2E0 




02E0 


0040 


1030 




.WORD START 




02E2 




1040 




.END 
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FLOATING POINT ROUTINES 



NAME I ADDRESS I 



DESCRIPTION 



APPROXIMATE 
MAXI-TIME(usec) 



AFP 

FASC 

IFP 

FPI 

FSUB 

FADD 

FMUL 

FDIV 

FLOOR 

FLDOP 

FLD1R 

FLD1P 

FSTOR 

FSTOP 

FMQVE 

PLYEVL 

EXP 

EXP 10 

LOG 

L0G10 

ZFRO 

AF1 

In BASIC ' 
Cartridge: 



SIN 
COS 
ATAN 
SQR 



D800 
D8E6 
D9AA 
D9D2 
DA60 
DA66 
DADB 
DB28 
DD89 
DD8D 
DD98 
DD9C 
DDA7 

DDAB 
DDB6 
DD40 

DDCO 

DDCC 

DECD 

DED1 

DA44 

DA46 



BDA7 
BDB1 
3E77 
BEES 



Ascii to Floating Point 
Floating Point to Ascii 
Integer to Floating Point 
Floating Point to Integer 
FRO — FRO - FR1 Subtraction 
FRO — FRO + FR1 Addition 
FRO — FRO * FR1 Multiplication 
FRO — FRO / FR1 Division 
Floating Load FRO using X,Y 
Floating Load FRO using FLPTR 
Floating Load FR1 using X,Y 
Floating Load FR1 using FLPTR 
Floating Store FRO using X,Y 
Floating Store FRO using FLPTR 
FRO — FR1 F.P. Move 
Polynomial Evaluation 



FRO — e 
FRO - 



FRO 



exponentiation 



.„FR0 .. .. 

10 exponentiation 



FRO — LOG (FRO) natural log 

e 

FRO — L0G 10 (FR0) common log 
FRO — 0 

clear page zero F.P. reg. (6 bytes) 



FRO — SIN (FRO) 

FRO — COS (FRO) 

FRO — ATAN(FRO) 

FRO — SQUARE ROOT (FRO) 

Times are for worst case, including 

OSR and RTS. 

Times are approximate. 

1 sec. = 1000000 usee. 
Times are approximately 30X-4Q?o less 
with DMA disabled (SDMCR): 

POKE 559,0 disable DMA 

POKE 559,34 enaole DMA 



3500 
950 
1330 
2400 
740 
710 
12000 
10000 
70 
60 
70 
60 
70 
70 
60 
88300 

115900 2.1s 

1038Q0 

136000 

125400 

SO 

80 



79400 
77400 
126700 
131100 



APPENDIX VI - CIO 



CIO 



CIOCHR= A REGISTER 
ICDNO = X REGISTER 




GET HANDLER ENTRY 
POINT VECTOR 



NO 



MOVE IOCB TO 


ZIOCB 






f 




YES 




YES 



' BAD IOCB 1 



A,Y» $86 
RETURN 



INVALID COMMAND ' 



A,Y= S84 
RETURN 



i 



SET SPECIAL 
FLAG 



OPEN 



YES 



CLOSE 



YES 



STATUS/ 
SPECIAL 



YES 



READ 



J 



;ed 





A, Y =$81 


NO 




> > 


RETURN 



'IOCB ALREADY OPEN' 



GET DEVICE 
NAME (ICBALZ) 



1 



GET ENTRY 
FROM HATABS 




NO 


A, Y = S82 




RETURN 



'NON-EXISTENT DEVICE* 



ICHIDZ=HATABS INDEX 
ECNNOZ=DEVI CS NUMBE R 



I 



GET POINTER TO 
HATABS ENTRY 



GET VECTOR TO 
HANDLER ENTRY 



I 



JSR (VECTOR) 



i 



FAKE PUTCHR TO 
SETUP ICPTL.ICPTH 



i 



RESTORE USER 
IOCB FROM ZIOCB 



i 



Y* ERROR 



C 



I 



RETURN 
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APPENDIX VII - QUME PRINTER HANDLER 



1 ; HANDLER USES THE FRONT PORTS TO SEND DATA TO A QUME PRINTER 

10 *=$3300 
20 CR=$9B 
30 SPCE=S20 
40 PIAB=$D301 
50 PIAC=SD303 
60 DOSVEC=S0A 

70 DOSINI«$0C 
80 HATABS=S031A 
90 MEML0=$2E7 
0100 ; 

0110 ; HANDLER ENTRY TABLE 
0120 ; 

0130 QHTBL .WORD QOPEN-1 



"CLOSE" 
"GET 1 ' 



"STATUS" 
"SPECIAL" 



DCSINI I NIT ON LOAD 



TRY TO INSTALL 
BY STEALING DOSINI 
RETURN 



0140 .WORD QXIT-1 
0150 . WORD CERR-1 
0160 .WORD CPUT-1 
0170 .WORD QXIT-1 
0180 .WORD QXIT-1 
0190 JMP QOPEN 
0200 QH00K1 LDA 
0210 STA DCSLNK 
0220 LDA DOS i N 1+1 
0230 STA DOSLNK+1 
0240 QHOOO JSR QINST 
0250 BCC 0H001 
026U RTS PASS 
0270 QH001 LDA #0HCCK&255 
0310 STA DOS I N I 
0320 LDA #0HCOK/256 
0360 STA DOS J N 1 4-1 
0370 RTS 

0380 QH0CK2 JSR J I ND 
0390 JMP QHOOO 
0400 J I ND JMP (DOSLNK) 
0410 DOSLNK .WORD SE477 LNK FOR I NIT 
0420 PITCH .BYTE S30 
0430 VPTCH .BYTE S60 
0440 ACUH .WORD 0 
0450 SPACES .WORD 0 . 
0460 QWD .WORD 0 



RETURN TO DOS 
FIRST I NIT DOS 
THEN INSTALL US 
I NIT DOS TOO 



I NIT QUME AND 
SOFTWARE VARIABLES 



0470 
0480 
0490 
0500 

0510 OOPEN IDA #0 
0520 LDX #5 

0530 01 LP STA ACUH,X CLR VARS 
0540 DEX 
0550 EPL 01 LP 

0560 QSET LDA PI AC SET FRONT PORTS 

0570 AND #SFB 

0580 STA PI AC PT TO DDR 

0590 LDY §1 

0600 STY PIAB SET 3 OUT 

0610 ORA, #4 

0620 STA PI AC 

0630 LDA #2 

0640 STA PIAB 

0650 BNE QSNDU RESTORE 

0660 ; 

0670 ; SEND A CONTROL WORD TO QUME 
06 SO ; 

0690 SNDYA STY QWD-1 
0700 SNDA STA QWD 
0710 QSND LDA PIAB 
0720 AND #8 

0730 BNE QSND WAIT FOR RDY 

0740 OSNDU LDY #16 

0750 LDA QWD 

0760 EOR n 

QUO STA QWO 

0780 QSLP LDA QWD 

0790 AND #1 

C800 ORA n 

0810 STA PIAB 

0820 JSR QOELAY 

0830 AND #1 

0840 STA PIAB 

0850 JSR QDELAY 

0860 ORA §2 

0870 STA PIA8 

0880 LSR QWD+1 

0890 RCR QWD 

0900 DEY 

0910 BNE QSLP 

0920 JSR QDELAY 

0930 ORA #4 STRCEE 

0940 STA PI A3 

0950 JSR QDELAY 

0960 AND #3 

0970 STA PIAB 

0980 RTS 



VI 



0990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1 120 
1 130 
1140 
1 150 
1 160 
1 170 
1 180 
1 190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 



$ 
9 



DELAY FOR LINE SETTLING 



QDELAY LDX #60 
QDLPO DEX 

BNE QDLFO 

RTS 

; SEND A CHARACTER FROM ACC 



CP UT CMP #CR 

BEQ OCR 

CMP #SPCE 

3CC RLY1 

BNE PUTFRT 

INC SPACES 
RLY1 BNE RLY2 
CCR LDA ACUH+1 

ORA #S40 

TAY 

LDA ACUH 
ORA §2 
JSR SNDYA 
LDA VPTCH 
ORA #3 
JSR SNDA 



(ALWAYS) 
(NEGATE IT) 



SEND TO QUME 
VERTICAL PITCH 

DO LINE FEED 



LDA #0 

STA ACUH 

STA ACUH+1 

STA SPACES 
RLY2 JMP OX IT 
PUTFRT PHA 

LDX SPACES 

BEO PPX 

LDA #0 

TAY 
PPLP CLC 

ADC PITCH 

BCC PPO 

I NY 



1390 PPO DEX 

1400 BNE PPL? 

1410 PHA 

1420 STX SPACES 

1430 CLC 

1440 ADC AC'JH 

1450 STA ACUH 

1 460 TYA 

1470 ADC ACUH+1 

1480 STA ACUH+1 

1 490 PLA 

1500 ORA #2 

1510 JSR SNOYA 

1520 PPX LDA #0 

1530 STA QWD+1 

1540 PLA GET CHAR BACK 

1550 ASL A 

156U BCC NOLND 

1570 LDY #5 

1 580 PHA 

1590 LDA iSr-i 

1600 JSR SNDYA 

1610 PLA 

1620 CMP #SPCS+SFCE 
1630 CLC 
1640 BNE NOLND 
1650 INC SPACES 
1660 JMP QXIT 
1670 NOUND ROL QWD+1 
1680 ASL A 
1690 ROL QWD+1 
1700 ASL A 
1710 ROL QWD+1 
1720 ASL A 
1730 ROL QWD+1 
1740 ORA #1 
1750 INC SPACES 
1760 JSR SNDA 
1770 QXIT LDY #1 
1780 RTS 



UNDERLINE IT INVERSE 
NOT A SPACE 
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1790 ; 

1800 ; ERROR EX iT 
1810 ; 

1820 QERR LDY #S8B 
1830 RTS 
1840 ; 

1850 ; INSTALL HANDLER IN HATABS 
1860 ; 

1870 QINST LDY #0 

1880 QINLP LDA HATABS, Y 

1890 CMP £530 FIND P: 

1900 BED QIPUT 

1910 i NY 

1 920 I NY 

1 930 I NY 

1940 CPY #S21 END OF TABLE? 

1950 BCC QINLP NO, LOOP 

1960 RTS ELSE RETURN 

1970 QIPUT LDA #CHTBL&255 

2010 STA HATABS+1 , Y 

2020 LDA #QHTBL/25c 

2060 STA HATAES+2, Y 

2070 LDA #QEND&255 

2110 STA MEMLO SET MEMLOL 

2120 LDA #QEND/236 

2160 STA MEMLO+1 SET MEM L OH 

2170 CLC 

2180 RTS 

2190 QENO-* 

2200 .END 
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RANDOM ACCESS 
by Bill Bart I aft 



DEFINITION OF RANDOM ACCESS 

Random access Is defined as any method of reading or writing records from/ to 
any part of a data file without first having to read through previous records 
of the file. 

Before any I/O command can be processed, the storage media must be physically 
positioned on the device to the correct byte location* A sequential device 
such as the ATARI 410 cassette tape drive must be positioned manually by the 
operator using the tape counter. Thus, If record 100 Is desired, the tape 
drive must first bypass records 1-99. It should be obvious that processing 
Is very time consuming simply because of the physical nature of the device. 

A random device such as the ATARI 810 disk drive can be positioned to any 
byte in a file under the control of a BASIC porgram. Thus if record 100 is 
desired, the disk drive can posftion there immediately. Random access is 
accomplished In a BASIC program with the POINT command. 

OPEN #1,12,0,"D1: " 

SECT0R=63 
BYTE=26 

POINT #1, SECTOR, BYTE 

The above commands cause the file opened on channel 1 to be positioned to 

sector 63, byte 26. The file must have been previously opened In mode 12 and 

sector 63 must have been allocated to the file by the File Manangement System 
(FMS) . 



GOALS 

1. Define a data file structure that facilitates random access. 

2. Maximize diskette utilization by using all available user space in a file. 

3. Simplify coding by developing subroutines to handle the most common random 
access processing. 

CONCEPTS 

1. Random access can be facilitated in 2 ways. 

First, store the sector and byte Information needed by the POINT command In 
the data file so that It can be readily assigned to a program variable when 
the file Is opened. Second, have the program variable use as little RAM as 
possible. 

A two-dimensional numeric array could be used as the program variable. 
However, each record would require 12 bytes of RAM. A string variable will 



VI I 1-1 



RANDOM ACCESS 



use less RAM because the sector number ranging 0-720 can be stored in 2 bytes 
3 nd the byte offset ranging 0-127 can be stored In 1 byte. 

2. Maximum diskette utilization Is accomplished by using mode 12 (I/O) 
Instead of mode 9 (append) In maintenance programs. 

Mode 12 is facilitated by allocating blank records to the data file when it 
Is created. 

3. Record allocation Is facilitated by having a 1 byte status byte for each 
record. A value of 0 Indicates the record is no, active. 
Indicates the record is active. 



FILE STRUCTURE 

A data file will consist of 3 sections. 

FILE HEADER RECORD 

FILE RANDOM ACCESS POINTERS 

DATA RECORDS 

The file header record Is the first sector of the file. It Is 125 bytes long 
(124 data + 1 delimiter). 

FILE HEADER RECORD 
BYTE CONTENTS 

1-2 sector address of file header record 

3 byte offset of file header record (0) 

4 not used 

5-6 # records in file 
7-8 # bytes in record 
9-124 not used 

The HI. rente* scoess posters l-~"«*'r "Mo. th. "'^f^TSllf 
this start in the seconc sector of th. flU. Th. £ *• used t0 

for each record In the file. 

FILE RANDOM ACCESS POINTERS 
^YT^ CONTENTS 

1-2^ sector address of file random access pointers 

3 byte offset of file random access pointers 

4 not used 



VI I I -2 



RANDOM ACCESS 



5-N 4 bytes for each record 

1-2 sector address of record 

3 byte offset of record 

4 status of record 

The data records Immediately follow the file random access pointers. They 
are stored as string variables 

RANDOM ACCESS SUBROUTINES 
K FILEOPEN.SUB 

This routine opens a file In mode 12 and Initializes the random access 
variables used In the other routines. 

I nput var i ab I es: 

FILES - must be dimensioned and assianed by the user (15 bvtes) 
CHANNEL - IOCS number (1-5) 

Ca I ! : 

GOSUB 9300 

Output varlab I es: 

FILEMAX - § records in file 
FILELEN - i bytes In record 

FILEPTRS - contains the random access pointers 
FILERECS - dimensioned for record I/O 

Scratch variables: 
FiLESEC 

F ! LE3YT These are not currently used 
FILESTS 



2. Fl LEADD.SUB 

This routine allocates the next available record by reading through FILEPTRS 
locking for a status byte of 0. When a status of 0 Is found, It is ser to 1 
and the record* Is stored In RECORD. If RECORD returns a value of 0, all 
records in the file are active. 

I nput variab I es: 
none 

Call : 

GOSUB 9400 

Output var; ab I es : 

RECORD- - record # of next available reccrc 
FiLEFTRS - updated with status byte of 1 
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Output variables: 

STS - value of status byte for record 

Scratch variables: 

S 
B 



9200 REM APPENDIX AND ROUTINES BY WILLIAM BARTLETT 
9300 REM 'F1LE0PEN.SUB' WBB 3-30-81 

9305 REM OPEN A FILE IN MODE 12 AND DEFINE ALL VARIABLES 
9310 OPEN /CHANNEL, 12,0, FILES 
9315 DIM FILEHEDS(124) 

9320 FOR 1=1 TO 124:GET /CHANNEL ,B: F I LEHEDS ( I ) "CHRS (8) J NEXT !:GET /CHANNEL, B 
9325 F I LESEC=ASC(F I LEHEDS ( 1 ) ) *255+ASC(F I LEHEDS ( 2) ) 
9330 F I LEBYT=ASC(F I LEHEDS (3 ) ) 
9335 FlLESTS=ASC(Fi LEHEDS (4)) 

9340 F I LEMAX=ASCC F I LEHEDS ( 5 ) ) *256+ASC( F I LEHEDS ( 6 ) ) 
9345 F!LELEN=ASC(FILEHEDS(7))*256+ASC(FILEHED$(8)) 
9350 DIM F I LEPTRS ( 4+4*F I LEMAX ) , F I LERECS ( F I LELEN ) 

9355 FOR 1=1 TO 4+4*F I LEMAX : GET /CHANNEL ,B: F I LEPTRS ( I ) =CHRS (B) : NEXT I :GET 

/CHANNEL, B 
9360 RETURN 



9400 REM 'F ILEADD.SUB 1 WBB 3-30-31 

9405 REM ALLOCATE THE NEXT AVAILABLE RECORD 

9410 RECORD-0 

941b IF FILEMAX-0 THEN RETURN 
9420 FOR RECORD 1=1 TO F I LEMAX 
9425 B=R£CORD 1 *4+4 
9430 IF Fi LEPTRS (B, 3) =CHRS(0) THEN 

RECORD-RECORD 1 : RECORD 1 =F I LEMAX : F 1 LEPTRS < B , 3 ) =CHRS ( 1 ) 
9435 NEXT RECORD 1 
9440 RETURN 



9450 REM 'FILEDEL.SUB' WB8 3-30-81 

9455 REM DELETE AN ACTIVE RECORD 

9460 B«REC0RD*4+4 

9465 FILEPTRS(3,3)=CHRS(0) 

9470 RETURN 
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9500 REM 'FILEPTR.SUB' WEB 3-19-81 
9510 REM WRITE FILEPTRS 

95 1 5 S=ASC(F I LEPTRS ( 1 ) ) *256+ASC( F I LEPTRS ( 2) ) 
9520 B=ASC(FILEPTR$(3)) 

9930 F0R N T=t^0 N 4+4*FI LEMAX :B=ASC(F I LEPTRS ( I )) :PUT # CHANNEL ,B : NEXT I 
9535 RETURN 



9600 REM 'FILEPOS.SUB' WBB 3-31-31 

9605 REM POINT FILE TO RECORD , . ,- r . nr „ 

9610 S=ASC(FILEPTRS(REC0RD*4+1))*256+ASC(FILEPTRS(REC0RD*4+2)) 

9615 B=ASC( F I LEPTRS (REC0RD*4+3) ) 
9620 STS=ASC(F I LEPTRS ( RECORD *4+4) ) 
9625 POINT #CHANNEL,S,3 
9630 RETURN 



I . INTRODUCTION TO FILEQ01 

This program is used to create a new disk data file, allocate its file space, 
and ini?taUze Its random access structure. The random access structure Is 
designed to Interface with the following BASIC subroutines. 



FILE0PEN.SU8 

F1LEADD.SUB 

FILEDEL.SUB 

FILEPTR.SUB 

FILEPOS.SUB 

I I . PROGRAM STRUCTURE 

0001-0999 main line logic 
1000-9999 subroutines 



111 PROGRAM LOGIC The 5 major execution phases are program initialization, 
file definition, screen setup, file allocation, and closing- 

A. Initialization 1000-1495 

1015 dimension variables 

1020 identify program to user 

1025-1035 allow user to exit program 

1040 set up BLANKS to be used as a string filler 

B. File Definition 1500-1999 

1510-1535 have user define parameters of file 

1540-1550 allow user to redefine parameters unti 1 C0 [" re< ~T. e^t*r*H 
1600-1545 search diskette dircetory to insure that the file spec!, Ted 

doesn't already exist 
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1700-1730 verify there are enough free sectors to create the file 
1800-1825 concatenate the filename 

C. Screen setup 9600-9650 

D. File A I location 2000-2499 

2005 create the file 

201 0 save poi nters 

2015 dimension variables 

FILEHEDS - file header record 

FILEPTRS - file pointer variable 

F I LERECS - record I/O variable 
2100-2180 set up FILEHEDS and send to file 
2200-2245 set up FILEPTRS and send to file 
2305 blank out F I LERECS 

2310-2345 store record pointers in FILEPTRS 
2350 refresh screen 

2355 send F I LERECS to file 

2370-2375 send final FILEPTRS to file 

E. Closing 0900-0999 



10 REM 'FILE0001' WBB 3-12-81 

100 REM MAIN LINE 

110 GOSUB 1000 

120 IF YNS="N" THEN 900 

130 GOSUB 1500 

140 GOSUB 9600 

150 GOSUB 2000 

900 REM END 

910 CLOSE #1 

920 GRAPHICS 0 

930 END 

1000 REM I NIT 

1005 TRAP 98CC 

1010 GRAPHICS 2 

1015 DIM YNS( 1 ), DVCS (3 ), F I LES ( 8), EXTS(3), F I LENAMESC 15 >,FMS1(1 6), 3LANKSC 128) 
1020 PLOT 5,4:PRINT #6; "F I LE0001 " 

1025 PRINT "THIS PROGRAM INITIALIZES A NEW FILE." 
1030 PRINT "DO YOU WISH TO PROCEED (Y/N) "; 
1035 INPUT YNS 

1041! BLANKS*" "iBLANKJt 128>«" ": BLANKS (2) -BLANKS 

1095 RETURN 

1500 REM DEF FILE 

1505 GRAPHICS 2 

1510 PRINT #5;"FILE DEFINITION" 

1515 PRINT " DEVICE ";:INPUT DVCS : DVCS (LEN( DVCS 5+1 )=":" 
1520 PRINT " FILE NAME ";: INPUT FILES 
1525 PRINT " EXTENTICN INPUT EXTS 
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1530 PRINT n f RECORDS ";:INPUT F ILEMAX 

1535 PRINT "REC LENGTH ■ ; : 1 NPUT HLELEN 

1540 PRINT "DO YOU WISH TO PROCEED CY/N) , 

1545 INPUT YNS 

1550 IF YN$<> w Y n THEN 1500 

1600 REM VERIFY FILE DOESNT EXIST 

1605 FMS$=DVCS:FMSS(LEN(FMS$)+1 >«"*.*" 

1610 OPEN #1,6,0,FMSS 

1615 INPUT #1 ,FMSS 

IS IF ^(l:SSc?lIS)S?LE$ OR FMSS(11,10+LEN(EXTS)X>EXTS THEN 1615 

!§3 PRINT "FILE ALREADY EXi STSI ";CHRS(253) 
1640 GOSUB 9850 

1645 GOTO 1500 . 

1700 REM VERIFY ENOUGH DISK SPACE EXISiS 

! 7?0 FReKv AL (FMS$(1,3»; NEED=F I LEMAX* ( F 1 LELEN+5 ) / 1 25+1 

\V£ KlSF^WS! "s PR I NT FREE; n FREE rt ;NEED; n NEEDED ! " ; CHR S ( 253 ) 

1725 GOSUB 9850 
1730 GOTO 1500 

1800 REM CONCATENATE FILENAME 
1805 F1LENAMES=DVCS 

1810 FILENAMES(LEN(F1LENAMES)+D=FILES 

1 81 5 F 1 LENAMES ( LEN(F I LENAMES )+1 >«"." 
1820 Fi LENAMES (LEN(F I LENAMES)+1 )-EXiS 

1825 RETURN , Mrv . 

2000 REM I NIT HEADER, POINTER, RECORD STRINGS 

2005 OPEN #1,8,0, FILENAMES 

2010 NOTE #1 ,F 1 LESEC,F I LE3YT ... '-,..„« en encntiFti FI cm) 

2015 DIM F 1 LEHED5( 124) ,F I LEFTRSC 4+4*F 1 LEMAX) ,F 1 LERECS(r LJ-EN) 

2100 REM FILE HEADER 
2105 F I LEHED$*8LANKS 
2110 HI=INT(FILESEC/256) 
2115 L0=FILESEC-HI*256 
2120 FILEHED$(1,D=CHRS(HI ) 
21 25 F I LEHEDS (2,2) -CHR5 ( LO) 
2130 F I LEHEDS (3,3) =CHRS ( F I LEaYT) 
2135 F I LEHEDS ( 4 , 4) =CHRS ( 0 ) 
2140 Hl=INT(FILEMAX/256) 
2145 L0=F I LEMAX -H I *256 
2150 FILEHED$(5,5)-CHR$(Hl) 
2155 F1LEHEDS<6,6)«CHR$<L0) 
2160 HI=INT(FILELEN/256) 
2165 L0=F1LELEN-H 1*256 
2170 FILEHEDS(7,7)=CHR$(HI) 
2175 FILEHEDS(8,8)=CHRS(L0) 
2180 PRINT #1 }F I LEHEDS 

Ifo? FOR ^ToTJS , LEVAX STEP 1 28 :F ! LEFTS St I ) "BLANKS !NEXT I 
2210 NOTE #1 ,S,3 
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2215 HI=INT(S/256) 
2220 LO=S-H 1*256 
2225 F I LEPTR5C 1 , 1 )=CKR$(H I ) 
2230 FILEPTR$(2,2)=CKRS(L0) 
2235 FILEPTRS(3,3)=CHR$(B) 
2240 FILEPTR5U,4)=CHRS(0) 
2245 PRINT #1;FILEPTR$ 
2300 REM RECORDS 

2305 FOR 1=1 TO F1LELEN STEP 128:F I LERECS ( I )=BLANKS:NEXT I 
2310 FOR 1=1 TO F1LEMAX 
2315 NOTE #1,S,B 
2320 HI=INT(S/256) 
2325 L0=S-HI*256 

2330 FILE?TRS( 1*4+1,1*4+1 )=CHRS(HI ) 
2355 F I LEPTRS( I *4+2, I*4+2)«CHR$(L0) 
2340 FILE=TRS( I *4+3, I *4+3)«CHR$(B) 
2345 F i IE?TR5( i *4+4, I *4+4)=CHRS( 0) 
2350 GOSUB 9700 
2355 PRINT #1;F I LERECS 
2360 NEXT I 
2365 CLOSE #1 

2370 OPEN #1,1 2,0, FILENAMES 
2375 GOSUB 9510 
2380 RETURN 
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9500 REM 'FILEFTR.SUB' WEB 3-19-81 

9510 REM WRITE FILEFTR ,.n. is-> 
9515 S=ASC(FILEPTRS(1,1))*256+ASC(F!LE?TRS(2,2)) 

9520 B=ASC(FILE?TR$(3,3)) 

9525 POINT #1,S,B 

9530 PRINT #1;FILEPTRS 

9535 RETURN „ att _ 

9600 REM DISPLAY SCREEN TEMPLATE 

9605 GRAPHICS 2 

9610 PRINT #6;"* INITIALIZING *" 

9615 PRINT 06 

9620 PRINT #6 ; "CURRENT" 

9625 PRINT #6;" TOTAL" 

9630 PRINT #6;" % COMP" 

9635 PRINT #6 

9640 PRINT #6;" SECTOR" 

9645 PRINT #6;" BYTE" 

9650 RETURN 

9700 REM REFRESH SCREEN 

9705 PLOT 10,2:PRINT §6; I 

9710 PLOT 10,3:PRINT #6;F!LEMAX 

9715 PLOT 10,4:PRINT £6 ; I NT( I /F I LEMAX* 1 00 ) 

9720 PLOT 10,6:PRINT #6;S;" " 

9725 PLOT 10,7:PRINT #6;B;" " 

9795 RETURN 

9800 REM TRAP. SUB 

llfo SiNt'-ERRCR - ; PEEKC195);" AT ";PEEKC 1 87)*256+PEEK( 1 86) 
9815 PRINT "ACKNOWLEDGE "} 
9820 INPUT YNS 
9825 END 

9850 REM 'DELAY. SUB' WEB 3-19-81 

9851 REM DELAYS EXECUTION FOR 2.5 ScC 

9852 REM (SCRATCH-P20) 

9860 P20-PEEK(20)+150:IF P20>255 THEN P2C=P^0-25o 
9865 IF PEEK(20X>P20 THEN 9865 
9870 RETURN 
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EXAMPLE PROGRAM 



10 REM »F1LEEX» WBB 3-31-81 

100 REM EXAMPLE OF RANDOM ACCESS ROUTINES 

101 REM THIS PROGRAM WILL PROCESS THE FILE D2: AREACODE.DAT 

102 REM WHICH SHOULD HAVE BEEN INITIALIZED USING 'F1LE0001' 

103 REM IT CONSISTS OF 24 BYTE RECORDS: 1-3 AREA CODE, 4-24 LOCATION DESC 

104 REM 

110 GRAPHICS 0 

120 PRINT "'FILEEX'":PRINT :PRINT "INITIALIZING" 

200 REM INITIALIZE VARIABLES 

210 DIM FILES(15),AC0DES(3),L0CSC21),YN$(1) 

220 CHANNELS 

230 F I LE5="D1 : AREA CODE. DAT" 
300 REM OPEN DATA FILE 
310 PRINT "OPENING DATA FILE" 
320 GOSUB 9300 

400 REM BEGIN OPERATOR INPUT 
410 PRINT 

420 PRINT "(0=END) AREA CODE ";: INPUT ACODES:IF ACCOE$="0" THEN 900 
500 REM SEARCH ACTIVE RECORDS FOR MATCHING AREA CODE 
510 MATCH=0 

520 FOR RECORD- 1 TO F I LEMAX 
530 GOSUB 9600 

540 IF STS-1 THEN GOSUB 5000 

550 NEXT RECORD 

560 IF MATCH- 1 THEN 400 

600 REM MATCH NOT FOUND, ALLOW ADD 

610 PRINT "MATCH NOT FOUND IN FILE!" 

620 PRINT "(Y/N) DO YCU WISH TO ADD ";: INPUT YNS 

630 IF YN$<>"Y" THEN 400 

700 REM ADD REQUESTED BY OPERATOR 

710 GOSUB 94C0 

720 IF RECGRD-0 THEN PRINT "FILE IS FULL, RECORD NOT ADDED !":GOT0 400 

730 PRINT "LOCATION: : INPUT LOCS 

740 FILERECS-ACC0E3 

750 FILERECi(4)-L0CJ 

800 REM PERFORM FILE UPDATING 

810 GOSUB 9600 

820 PRINT /CHANNEL; F I LERECS 

830 GOSUB 9300 

840 GOTO 400 

900 REM ALLOW DELETES 

910 PRINT 

920 PRINT "(Y/N) DO YCU WISH TO DELETE ANY ";: INPUT YNS 
930 IF YNS<>"Y" THEN 1200 
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1000 REM SPECIFY WHICH TO DELETE 
1010 PRINT 

1020 PRINT "(0=END) AREA CODE ";: INPUT ACODE$:IF ACODES="0" THEN 1200 

1100 REM SEARCH ACTIVE RECORDS FOR MATCHING AREA CODE 

1110 FOR REC0RD=1 TO FILEMAX 

1115 GOSUB 9600 

1120 IF STS=1 THEN GOSUB 5100 

1125 NEXT RECORD 

1130 GOSUB 9500 

1140 GOTO 1000 

1200 REM PRINT FILE TO SCREEN 

1210 PRINT :PRINT "CODE", "LOCATION": PR I NT 

1220 FOR RECORD' 1 TO FILEMAX 

1230 GOSUB 9600 

1240 IF STS=1 THEN GOSUB 5200 

1250 NEXT RECORD 

1300 REM ALLOW HARDCOPY „ vxt , 

1310 PRINT :PRINT "(Y/N) DO YOU WANT A PRINTED LIST ";: INPUT YNS 

1320 IF YN5<>"Y" THEN 4900 

1330 LPRINT "CODE", "LOCATION": LPRINT 

1340 FOR RECCRD=1 TO FILEMAX 

1350 GOSUB 9600 

1360 IF STS=1 THEN GOSUB 5300 

1370 NEXT RECORD 

1380 GOTO 4900 

4900 REM END 

4910 CLOSE a? CHANNEL 

4920 PRINT "END CF EXECUTION" 

4930 END 

5000 REM FROCESS ACTIVE RECORD/DISPLAY 
5010 INPUT ^CHANNEL ,F I LERECS 
5020 IF Fi LERECS (1, 3 )<>ACODES THEN RETURN 
5030 MATCH=1 

5040 PRINT "LOCATION: " ;F I LERECS < 4) 
5050 RETURN 

5100 REM PROCESS ACTIVE RECORD/DELETE 
5110 INPUT s?CHANNEL,F I LERECS 
5120 IF FIL£REC3(1,3X>AC0DES THEN RETURN 
5130 GOSUB 9450 

5150 PRINT "DELETED ";F I LERECS (4) 
5160 RETURN 

5200 REM PROCESS ACTIVE RECORD/PRINT 

5210 INPUT ^CHANNEL ,F I LERECS 

5220 PRINT FILERECS(1,3),FILERECS(4) 

5230 RETURN 

5300 REM PROCESS ACTIVE RECORD/LPRI NT 
5310 INPUT ^CHANNEL ,F I LERECS 
5320 LPRINT F I LERECS ( 1 ,3) ,F ! LERECS ( 4) 
5330 RETURN 
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9300 REM 'F I LEOPEN .SUB ' VrBB 3-30-81 

9305 REM OPEN A FILE IN MODE 12 AND DEFINE ALL VARIABLES 

9310 OPEN /CHANNEL ,12,0, FILES 

9315 DIM F I LEHEDS ( 124) 

9320 INPUT f CHANNEL ,F I LEHEDS 

9325 F I LESEC=ASC(F I LEHEDS ( 1 ) )*256+ASC(F I LEHEDS ( 2) ) 
9330 F I LEBYT=ASC(F I LEHEDS (3 ) ) 
9335 FILESTS=ASC(FILEHED5(4)) 

9340 F I LEMAX=ASC(F I LEHEDS ( 5 ) ) *256+ASC(F I LEHEDS ( 6 ) ) 
9345 F I LELEN=ASC ( F I LEHEDS (7) )*256+ASC(F I LEHEDS ( 8 ) ) 
9350 DIM F I LEPTRS ( 4+4*F I LEMAX) ,F I LERECS (F I LELEN ) 
9355 INPUT /CHANNEL ,F I LEPTRS 
9360 RETURN 

9400 REM 'FILEAOD.SUB' WBB 3-30-81 

9405 REM ALLOCATE THE NEXT AVAILABLE RECORD 
9410 RECCRD=0 

9415 IF F ! LEMAX-0 THEN RETURN 
9420 FOR RECORD 1 = 1 TO F I LEMAX 
9425 B=RECORD 1*4+4 
9430 IF FILEPTRS(B,3)=CHRS(0) THEN 

RECORD-RECORD 1 ! RECORD 1 =F I L EMAX : F I LEPTRS ( B , 3 ) =CHRS ( 1 ) 
9435 NEXT RECORD 1 
9440 RETURN 

9450 REM 'FILEDEL.SUB' WBB 3-30-31 

9455 REM DELETE AN ACTIVE RECORD 

9460 B=REC0RD*4+4 

9465 FIL£?TRS(3,3)=CHRS(0) 

9470 RETURN 

9500 REM »F I LEPTR.SUB' WEB 3-19-81 
9510 REM WRITE F I LEPTRS 

95 1 5 S=ASC ( F I LEPTRS ( 1 ) ) * 256+ASC ( F ! LEPTRS ( 2) ) 
9520 B=ASC(FILE?TRS(3)) 
9525 POINT #1 ,S,B 
9530 PRINT #1 ;FI LEPTRS 
9535 RETURN 

9600 REM »F!LE?CS.SUB' WBB 3-31-81 
9605 REM POINT FILE TO RECORD 

9610 S«ASC(F I LEPTRS (REC0RD*4+1 ) )*256+ASC( F I LEPTRS (RECCRD*4+2) ) 
9615 B=ASC(F I LEPTRS ( RECORD* 4+3 ) ) 
9620 STS«ASC( F t LEPTRS ( REC0RD*4+4 ) ) 
9625 POINT /CHANNEL, S,B 
9630 RETURN 
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POWER-UP 



NO (MIDDLE 
OF COLDSTART) 



SEI 
WARMST=0 




.a* 



GOTO STANDALONE 
DIAGNOSTIC 
CARTRIDGE 
(3MP ( SBFFE) ) 



NO 



FIND # OF 4K BLOCKS 
OF RAM (TRAMS2) 
INITIALIZE POKEY, ANTIC, 
CTIA/GTIA 



CLEAR O.S. RAM 
(S200-3FF,$10-7F) 



(RESET) NQ 




YES(POWERUP) 



CLEAR ALL RAM 
(S08-TRAMSZ) 
SET DEFAULT CARTRIDGE TO 
BLACKBOARD (DOSVECsBLKBDV) 
SET COLDST TO MIDDLE OF POWER-UP 
(COLDSTrSFF) 



I 

i 



SET SCREEN MARGINS 
(LMARGN=2 
RMARGN=39) 



MOVE IRQ VECTOR TABLE 
FROM ROM TO RAM 
(VDSLST-VVBLKD) 




I 
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CLEAR BREAK KEY (BRKKEY-SrE) 
SET MEMORY SIZE 
RAMSIZ-TRAMSZ 
MEMTOP-TRAMSZ 
MEMLO-$70O 




INITIALIZE DEVICE HANDLERS 


EDITOR 


(E: ) 


SCREEN 


(S:) 


KEYBOARD 


(K:) 


PRINTER 


(?:) 


CASSETTE 


(C:) 




SET CASSETTE BOOT 
(CKEY-l) 




m CASSETTE BOOT 
(CKEY-O) 




INTERRUPTS 





MOVE DEVICE HANDLER 
TABLE FROM ROM TO RAM 
( T3LENT -* HATA3 S ) 




INITIALIZE 
B CARTRIDGE 
(JSR(9FEE)) 



1 



CLEAR 3 CART. 
FLAG(TSDAT-O) 



i 



SET 3 CARTRIDGE 
FLAG(TSDAl-l) 
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DO CASSETTE 
BOOT 



YES 




VE5 



B00T?=2 



PRINT ' BOOT ERROR 1 
ON SCREEN 



i 



BCOT?=1 








YES 



- 



INITIALIZE 
A CARTRIDGE 
(OSR($BFFE) ) 



— — 



CLEAR A CART. 
FLAG (TRAMS2=0) 
(0SR($8FFE) ) 



} 



SET A CART. 
FLAG(TRAMSZ=1) 



OPEN EDITOR 
(E:) 




^ POWER-UP 




- 



WAIT FOR VBLANK 
TO SET UP SCREEN 




YES (RESET) 



NO(POWERUP) 




YES 



RUN PROGRAM 
BOOTED 
CTSR(CASINI)) 



NO 
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DO DISK BOOT 






< — — ' 


YES 






YES t 



CLEAR POWER-UP 
FLAG (COLDST=0) 



GOTO A 
CARTRIDGE 
UMP($BFFA>) 



YES 



RUN 
CARTRIDGI 

NO 



i 



GOTO B 
CARTRIDGE 
(3MP(S9FFA)) 



YES 



RUN 

cartridg; 
? 



NO 



GOTO DOS OR 
CASSETTE PROGRAM OR 
BLACKBOARD 



i 
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$ 

The symbol which indicates a number should be Interpreted as hexadecimal. 
ANTIC 

This Is a separate microprocessor contained within the ATARI 400/800 
which Is dedicated to the television display. ANTIC Is user-programmable 

with an instruction set, a program (the "display list"), and data (the 
,f d isp I ay memory") . 



ATTRACT MODE 

This Is a feature provided by the operating system which, after nine 
minutes without a key being pressed, cycles the colors on the screen through 
random hues at lowered luminances. This Insures that a computer left 
unattended for several hours doesn't burn a static image Into the television 
screen . 



BACKGROUND 

The area of the television screen display upon which playei — missile 
graph ics* objects or playfleld objects and/or text are projected. Background 
has Its own user-definable color. 



BORDER 

In BASIC Mode 0, this is the area of the television screen display which 
Is formed by the four edges of the screen. The border takes background color. 



BRKKEY 

A flag set when the OS senses that the BREAK key Is typed. BRKKEY f s 
normal vaiue Is 5FF — If It changes, then the BREAK key has been typed. 

BYTE COUNT 

This Is the file pointer's position within a sector on diskette. 



CASSETTE BOOT FILE 

A standard or user-created file which boots from cassette at power-uo or 
SYSTEM RESET. 



GLOSSARY 



CHARACTER GRAPHICS 

The technique of redefining the Individual characters of a character set 
to form graphics Images Instead of text characters. 

CHARACTER IMAGE 

The unique 8X8 pixel grid which defines a particular character's shape. 
CHARACTER MODE 

This Is a specific type of ANTIC display mode which displays screen 
display memory data bytes as characters, using a character set. There are 6 
ANTIC character modes, 3 of which are accessible from SASIC. 



CHARACTER NAME BYTE 

A one-byte ANTIC display memory value which selects a unique character 
within the current character set by the character's numerical position In 
that set, 

CHARACTER SET INDIRECTION 

The technique of specifying to ANTIC a particular character set to be 
used by placing that set's beginning page address Into CHBAS . 

* 

CHBAS 

The OS shadow location which ANTIC uses to find the current character 
set which Is to be used for character display modes* CHBAS Is at decimal 
address 756. 

CHECKSUM 

This Is a single byte sum of all the bytes In a record (either disk I/O 
or cassette I/O). For cassette I/O this Includes addition of the two marker 
characters, computed with end-around carry. 

CIO 

Acronym for Central I/O system routine. CIO routes I/O control data to 
the correct device handler and then passes control to the handier. CIO Is 
also the common entry point for most of the OS I/O functions. 
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COARSE SCROLLING 

The process of altering the display list LMS (Load Memory Scan) address 
bytes In order to vertically or horizontally scroll the screen image, one 
byte at a time. This Is accomplished by adding 1 to or subtracting 1 from 
the LMS address bytes. 



COLD START 

Synonym for the power-up process which performs a series of system 
database Initializations when the computer power switch Is turned on. After 
coldstart, the system surrenders control to the user. 



COLLISION 

This occurs when a player image In playei — missile graphics coincides 
with another Image. There are 60 possible collisions and each one has a bit 
assigned to It that can be checked. These bits are mapped Into 16 registers 
In CTIA (with only the lower 4 bits used). 



COLLISION DETECTION 

Primarily of value for games. This Is a hardware- imp I emented ability to 
detect If any one of The 60 player-missile collision poss ib I I iTies has 
occurred . 

COLOR 

One of 128 values obtained from a hue-iumlnos Ity combination which Is 
stored In a color register. 

COLOR CLOCK 

The standard unit of horizontal distance cn the television screen. 
There are 228 color clocks In a horizontal scan line. 



COLOR REGISTER 

A hardware register (with corresponding OS shadow location) used to add 
colcr to various portions of the screen display. There are 9 color registers 
available cn the ATARI Personal Computer System. 



COLCR REGISTER I NO I RECTI ON 

The technique of specifying a particular color by coding Its value Into 
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a color register. 



COLOR SIGNAL 



„?s era ax'ss ass.'.* ^k^ito. 



s!g 

at 3.579 MHZ 



COLRSH 



f<AP^ «at ud and updated by the OS during vertical 
COLRSH Is given a new random value every four seconds. 

COMMAND 

In BASIC this Is the first executable token of a BASIC statement that 
tells BASK 5o Interpret the tokens that follow In a particular way. 

CONSTANT 

m rasic this Is a six-byte ECO value preceeded by a special token. 
This value "remains unchanged throughout the program execution. 

CONTROL BYTE 

In cassette 1/0, this Is part of every record. It contains one of three 
possible values. 

CT1A 

A television Interface chip which Is controlled primarily r by ANTIC 

CTIA converts ANTIC'S digital commands Into a signal that Is sent ,o ,he 
television. 

CURRENT STATEMENT 

in BASIC, this Is the current token within a line of the Statement Table 
CYCLE STEALING 

this cccurs when ANTIC interrupts 6502 processing in order to perform 
DMA functions for screen display purposes. 
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CYCLIC ANIMATION 

The technique of repetitively flipping through colors, graphics Images, 
or character graphics sets to animate screen Images. 

DC8 

Acronym for Device Control Block. The DCS Is used by the I/O subsystem 
to communicate between the device handlers and SIO. 

DEVICE HANDLERS 

Routines present in OS ROM which are called through CIO (as long as the 
handler has an entry In HATABS) to communicate to particular devices. 
Currently supported are the Display Editor, the Screen, the Keyboard, the 
Printer, and the Cassette. 

DEVICE SPEC 

A special HATABS code which specifies a particular I/O device. 

DIAGONAL SCROLLING 

This results from the combination of horizontal and vertical scrolling 
of the screen image. 

DISPLAY FORMAT 

A screen Image on paper which is translated Into a sequence of mode 
lines which themselves eventually get translated Into ANTIC's display list 
Instructions . 



DISPLAY LIST 

ANTlC ! s "program" defined by the user or provided automatically (through 
a GRAPHICS command) by BASIC. The display list specifies where the screen 
data may be found, what display modes to use to Interpret screen data, and 
what special display options (If any) should be Implemented. 

DISPLAY LIST INTERRUPT 

A special ANTIC display list instruction which Interrupts the 6502 
micrcDrccessor during the drawing of the screen image, allowing the 63G2 to 
change the screen parameters. 
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DISPLAY MODE 

Either a BASIC or ANTIC methodology for Interpreting text or map data 
bytes In screen memory and displaying them on the screen • 

DLI VECTOR 

This Is a two-byte pointer (lo byte, high byte) to the Display List 
Interrupt service routine. This vector Is set by the user and Is located at 
[512,513] decimal . 



DMA 

Direct Memory Access. This occurs when ANTIC or the 6502 fetch an 
Instruction byte or data byte from memory. 

DMACTL 

The hardware register whose bit settings control, among other things, 
player vertical resolution and p I ayer-ml ss 1 1 e graphics enabling. 



DOS 

Acronym for Disk Operating System which is an extension of the OS that 
allows the user to access disk drive mass storage as files. 



DOUBLE-LINE RESOLUTION 

A unit of vertical resolution for a player in p I ayei — ml ss 1 1 e graphics. 
E2Ch player byte occupies two horizontal scan lines on the screen, and each 
player table Is 128 bytes long. 



DRKMSK 

A zero-page (S4E) location set up and updated by the OS during vertical 
blank Interrupts for ATTRACT mode processing. Usage of DRKMSK lops off the 
highest luminance bit of the right nybble of a color register's value. This 
Insures a low luminance for ATTRACT mode. 



DUP 

Acronym for Disk Utility Package. DUP Is a set of utilities for 
diskette, familiarly seen as the DCS menu. DUP executes commands by calling 
FMS through CIO. 
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DYNAMIC DISPLAY LIST 

This Is an ANTIC display list which the 6502 changes during vertical 
blank periods, allowing for even a greater degree of flexibility in the 
screen display. 

EOL 

In BASIC, "End-of-Line", a character with the value 593. 

FILE 

in cassette I/O, this consists of a 20-seccnd leader of the mark tone 
plus any numoer of data bytes, and end-of-file. In diskette I/O this 
consists of a numoer of sectors linked by pointers (125 data bytes per 
sector) . 



FILE POINTER 

For diskette I/O, this Is a value which Indicates the current position 
In a file by specifying the Sector Number and the Byte Count. DCS keeps a 
file pointer for every file currently open. 

FINE SCROLLING 

The process of horizontally or vertically scrolling a screen image In 
color clock or scan line Increments. The horizontal scrolling and vertical 
scrolling hardware registers must be used to fine scroll. 

FMS 

File Manager System. FMS is a ncn-resldent device handler which 
supports seme special CIO functions. 



FONT 

A collection of characters which constitutes a character set. These 
characters can be either text or graphics images. 

FOREGROUND 

Equivalent to p 1 ay f f eld, the area of the screen which directly overlays 
the background of the screen. Foreground Is fonred by map displays and/or 
i exT • 
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FORMAT 

A resident disk handler command that clears all the tracks on diskette. 
FUNCTION 

In BASIC, a token that when executed returns a value to the program. 

GRAPHICS INDIRECTION 

A soeclal feature of the ATARI system which allows color register and 
character se? generality by using Indirect pointers to color and character 
set values. j 

HATABS 

The device handler entry point table which is used by CIO. HATABS is 
located at 5031 A. 

HORIZONTAL BLANK 

This Is the period during which the electron beam (as It draws the 
screen Image) returns from the right edge of the screen to the left edge. 

HORIZONTAL POSITION REGISTER 

A soeclal I zed register which contains a user-definable value for the 
hor I zonta! position of a player In player-missile graphics. This value Is In 
units of color decks. 

HORIZONTAL SCAN LINE 

The fundamental unit of measurement of vj -tlcal J^J" ' 

The scan line Is formed by a single trace of the electron beam ac. oss .he 



screen 



HORIZONTAL SCROLL ENABLE BIT 

This is bit D6 of the ANTIC display Instruction which enables horizontal 
scrolling through the HSCROL register. 

HORIZONTAL SCROLLING 

This is the process of "sliding" the screen "window" to the left or 
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right over display memory In order to display more information than could be 
seen with a static screen. Either coarse or fine horizontal scrolling Is 
aval I able. 



HSCROL 

This Is the horizontal fine scrolling register located at SD404, 
containing the number of clc~<s by which a line Is to be horizontally 
scrol led. 



HUE 

The upper nybble value of a color registers color. There are 16 
possible hues (SO to SF) which In combination with a luminosity value 
constitute distinct "colors." Examples of hues are "black", "red", and 
"gold." 



I/O SUBSYSTEM 

A set of system routines that interface to the I/O hardware. 



I/O SYSTEM CONTROL BLOCKS 

These blocks are elements of the I/O subsystem which are used to 
communicate Information about the I/O function to be executed. 



I MMED I ATE MODE 

In BASIC, the mode where the Input line Is not preceeded by a line 
number. BASIC immediately executes the line. 

INPUT BAUD RATE 

For cassette I/O, this is assumed to be a nominal 600 baud (physical 
bits per second). However, this rate Is adjusted by SIC to account for drive 

motor variations, stretched tape, etc. 



INPUT LINE BUFFER 

In BASIC, from $580 to S5rr. 



INTER-RECORD GAP 

For cassette I/O records, this consists of the Pcst-record gap of a 
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given record followed by the Pre-record Write Tone of the next record. 
INTERIM MASTER 

in the mass production of cassette tapes, this Is the backup copy for 
the Work Master tape. 

IOCS 

Acronym for Input/Output Control Block. There are eight of these whose 
function Is to tunicate between the user programs and CIO. 

IRQ 

Maskable (can be enab.ed or disabled by the 6502) .nterrupts such as the 
Break Key IRQ. 

I RQEN 

The write-only register that contains the IRQ enable/disable bits. 
I RQEN Is shadowed at POKMSK. 

KERNEL 

loop which Is precisely f i™< ™ .™%°'^ ^consults a table of screen 
arbitrarily control all graphics values for the entire screen. 



LINE 



,, M of cn8 or more BASIC statements preceeded 

line n'ZeTZ The range o? 0 to 32767. or an Mediate mcPe line 



In BASIC, 
either by a 1 1 
with no I tne number. 

LCMEM 

in BASIC this Is the pointer (C80,8l3 decimal) to a buffer used to 
tokenlze one %Z of code. ? The buffer Is 256 bytes long, residing at The end 
of the operating system's allocated RAM. 

LUMINANCE 
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The lower nybble of a color register 9 $ color. There are 8 even-numbered 
values for luminance ($0 to SF, even values only) which In combination with 
hue values produce the 128 "colors" available on the ATARI 400/800. 



MAP MODE 

This Is a specific type of ANT! C display mode using simple colored 
screen pixels Instead of characters for the screen display. There are 8 
ANTIC map modes, with varying degrees of resolution. Six of these are 
cal I able from BASIC. 



MARK 

For cassette 1/0, this Is a 5327 HZ frequency. 



MARKER CHARACTER 

For cassette 1/0, this Is a 55 (hex) value whose purpose Is for 
adjusting the baud rate. Including the start and stop bits, each marker 
character Is 10 bits long, 

MASTER TAPE 

In cassette tape mass production, this Is an open-reel, 1/4 track, 1/4 
Inch tape recorded at 7 1/2 Inches per second. The Master Tape becomes the 
Source Master prior to the duplication process. 

MEMTDP 

In BASIC, a pointer ([90,91 j decimal) to the top of application RAM, the 
end of the user program. Program expansion can occur from this point to the 
end of free RAM, which Is defined by the start of the display list. This 
MEMT0P Is not the same as the OS variable called MEMTCP. 



MISSILE 

A one-dimensional Image In RAM used In p I ayei ml ss i I e graphics which is 
2 bits wide. There Is a maximum of 4 missiles, one for each player. 



MISSILE COLOR 

The color of a missile In player-missile graphics. Each of the four 
missiles takes on the color of Its associated player. 
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MCDE LINE 

A collection of horizontal scan lines for screen displays. Depending 
upon the BASIC or ANTIC display mode In effect, a mode line will be composed 
of varying numbers of scan lines. By the same token, depending upon the 
display mode, a screen Image will be composed of varying numbers of mode 
I I nes . 



MON I TOR 

A program In ROM that handles both the system power-up and SYSTEM RESET 
sequences. 

N-SIT 

A 6502 processor status register bit which Is set by, among other 
things, I/O calls to Indicate the sucess or failure of an I/O operation. 



NARROW PLAYFIELD 

A screen display width option equal to a width of 123 color clocks. 



NMI 

Non-Maskable Interrupt (I.e., cannot be disabled by the 6302). The 
Display List Interrupt and the Vertical Blank Interrupt are both NMIs. These 
can be disabled with the ANTIC NMI EN register. 



NMI EN 

The Non-Maskable Interrupt Enable relster which controls enabling of 
various Interrupts such as the Display List Interrupt (DLI). 



NORMAL IRG MODE 

In cassette I/O, this Is a mode where the tape always comes to a stop 
after each record Is read. If the computer stops the tape and gets Its 
processing done fast enough, then the next read may occur so quickly that the 
cassette deck may see only a slight dip In the control line. 



NORMAL PLAYFIELD 

A screen display width option equal to a width of 160 color clocks* 
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OPERATOR 

In BASIC, any one of the 46 tokens that in some way move or modify the 
values that follow them. 



OPERATOR STACK 

In BASIC, a software stack where operators are placed when an arithmetic 
BASIC expression is being evaluated. 

OVERSCAN 

The "spreading out" of a television image by the raster scan method of 
display so that the edges of the picture are off the edge of the television 
tube. This guarantees no unsightly borders In the television picture. 

PIXEL 

The standard point-unit of vertical distance on the television screen. 
The normal limit of a television set used with the ATARI 400/800 is 192 
p Ixels vertical ly . 



PLAYER 

A one-dimensional RAW Image used In pi aye! — missile graphics which can he 
128 bytes (double-line resolution) or 255 bytes (single-line resolution) 
long. The player appears as a vertical band 8 pixels wide stretching from 
the top of the screen to the bottom. There Is a maximum of four Independent 
players. 



PLAYER COLOR 

The color of a player in piayei — missile graphics. Each of the four 
independent players has its own color stored In its associated color register. 



PLAYER-MISSILE AREA 

A RAM area which contains the Images of the four players and four 
missiles of player-missile graphics, as well as some extra RAM. The 
player-missile area must be on a IK boundary for single-line resolution 
players or a 2K boundary for double-line resolution players. 



PLAYER-MISSILE GRAPHICS 

Atari's solution for simplifying animation by creating an Image (a 
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•player' or 'missile') which is one-dimensional in RAM but two-dimensional on 



the screen 



PLAYF I ELD 

The area of the screen which directly overlays the background of the 
screen. Map graphics and/or text form this playfield. 

PLAYFIELD ANIMATION 

The technique of animating an object by moving Its ^d 1 mens iona. image 
bytes to new locations in screen memory, and then erasing the defining y 
of the old image before displaying the newly-moved Image. 

PMBAS 

A register which points to the beginning of the player-missile area. 

POKEY 

A digital I/O chip which handles the serial I/O bus ^^|o generation, 
keyboard scan, and random numoer generation PCKcY also d,g ^ f 
resistive paddle inputs and controls masKable inrerrupx m^v s 

POKEY TIMERS 

Unlike System Timers, the POKEY chip timers are clocked by frequencies 
set by the user. 

POST-RECORD GAP 

A pure mark tone frequency used as a post-record delimiter in cassette 

I/O. 

PRE-RECORD WRITE TONE 

A pure mark tone frequency used as a pre-reccrd delimiter in 
I/O. 

PRIMARY SIGNAL 

This contains the luminance information - brightness data, horizontal 
and verbal syncs and blanks - of the modulated television signal. 
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PRIORITY -CONTROL REGISTER 

Also known as PRIOR, and shadowed at GPRIOR. This register specifies 
which playfleld, player, or background Images have priority In tne case of 
Image overlaps during the screen display process. 



RAM Y ECTOR 

Alterable system vector that contains two-byte addresses to system 
routines, handler entry pointers, or to Initialization routines. RAM vecTors 
are Initialized at power-up and SYSTEM RESET. 



RASTER SCAN 

A television display system which uses an electron beam generated at the 
rear of the television tube. The beam sweeps across the screen in a regular 
left-to-rlght, top -to-bottom fashion. 



RECORD 

For diskette I/O, a group of bytes delimited by ECLs (598). For 
cassette I/O, this is a group of 132 bytes which is composed of 2 marker 
characters for cassette speed measurement, a control byte, 128 data bytes, 
and the checksum byte. 



REDEFINED CHARACTER SET 

Any user-defined character set designated for use by ANTIC other than 
the standard character set in ROM. CH3AS (decimal address 756) contains the 
beginning page address of any redefined character set. 



RESIDENT DISK HANDLER 

This software performs five Important low- 1 eve I disk I/O functions such 
as FORMAT, READ SECTOR, WRITE SECTOR, WRITE/ VERIFY SECTOR, ana STATUS. 



ROM VECTOR 

Unalterable system vector that contains JMP Instructions to system 
routines. 



RTCLQK 

One of the system timers which is 3 bytes In length and is updated 
during immediate VBLANK. RTCLCK can be used as an application's timep! 
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RUNSTK 

In BASIC, a pointer (C8E,8F] decimal) to the Run Time Stack. 
RUN TIME STACK 

In BASIC, a software stack which contains GOSUB and FOR/NEXT return 
address entries. 

SCREEN MEMORY 

A RAM area used by the 6502 to store bytes of data that will be fetched 
(by DMA) by ANTIC to be Interpreted and eventually displayed as Images on the 
screen • 

SECTOR 

On a diskette, this Is a 128-byte physical area. The diskette contains 
40 tracks with 13 sectors per track. 

SECTOR NUMBER 

A value from 1 to 719 which designates to which diskette sector the file 
pointer Is currently pointing. 

SETVBV 

A system routine which, among ether functions, correctly sets the system 
timers and sets user-definable Interrupt vector addresses, 

SHADOWING 

The process whereby a software location is used by the OS to update 
hardware registers during vertical blank periods. 

SHORT IRG MODE 

In cassette I/O, this means the tape Is not stopoed between records. 
The BASIC commands n CSAVE n and "CLOAD" both specify this mode. 

SINGLE-LINE RESOLUTION 
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A unit of vertical resolution for a player In p I ayei mi ss 1 1 e graphics. 
Each player byte occupies one horizontal scan line on the screen, and each 
player table Is 256 bytes long. 

SIO 

Serial 1/0 system routine which handles communication between the serial 
device handlers in the computer and the serial bus. 

SIO INTERRUPTS 

These are 3 IRQ Interrupts used by SIO to send and receive serial bus 
ccrmun i cat ions +o serial bus devices. These 3 are VSER1R (Serial Input 
Ready), VSERCR (Serial Output Needed), and VSERCC (Transmission Finished). 

SOUND REGISTER 

Audio-producing hardware In the ATARI Personal Computer System which 
contains frequency, volume, and distortion information, but not duration. 



SOURCE MASTER 

In the mass production of cassette tapes, this Is identical to the 
Master Tape, 



SPACE 

For cassette I/O, this Is a 3995 HZ frequency output to the casseTte 
tape as a delimiter In conjunction with mark tones. 



STANDARD CHARACTER SET 

The default characfer set resident In ROM which is used by the ATARI 
400/800. 



STARP 

In BASIC, the pointer ([3C,SDJ decimal) to the String Array Area. 
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STATEMENT 

In BASIC, this Is a complete 
perform some meaningful task. .In 
colons . 



"sentence" of tokens that causes BASIC to 
LIST form, statements are separated by 



STATEMENT TABLE 

in BASIC, this is a block of data which include. , all the lines of code 
that have been entered by the user and token, zed by BASIC. This table also 
includes the immediate mode line. 



STMCUR 

In BASIC, the pointer (C8A,8Bl decimal) to the current BASIC statement. 



STMTA3 

In BASIC, this is the pointer (C88,39] decimal) to the Statement Table 



STRING ARRAY AREA 

In BASIC, this block contains all the string and array data. 



SYNC MARK 

This Is a 3995 HZ Space frequency used as a sort of "end-of-record» 



SYSTEM DATABASE 

This Is an area which occupies RAM Pages 0 through 4, containing many 
locations that store Information of interest to the user. 



SYSTEM TIMER 

A timer provided by the ATARI 400/8C0 that runs at the frequency of the 
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television frame which for North American T.V.s (NTSC) Is 59.923334 HZ. 
European (PAL) televisions run at 50 HZ. There are 6 system timers, and they 
are clocked as part of the vertical blank process. 



TELEVISION ARTIFACT 

7hfs refers to a spot or "pixel" on the screen that displays a dlfferen 
color than the one assigned to it. "Art I fact I ng" Is possible in ANTIC modes 
2, 3, and 15 which correspond to BASIC modes 0, no mode, and 8. 



TEXT WINDOW 

On a screen display, this is a two-dimensional area set aside for 
textual I/O with the user. 



In BASIC, an 8-bit byte containing a particular execution code, 
TOKEN I Z I NG 

In BASIC, this Is the process of getting a line of Input and creating a 
series of 8-bit bytes which contain tokens, meaningful execution codes. 



In BASIC, a token that is an Indirect pointer to Its actual value. 



VARIABLE NAME TABLE 

In BASIC, this is the table containing a list of all the variable names 
that have been entered In a program. 



VARIABLE VALUE TABLE 

In BASIC, this rable contains current Information on each variable. 



TOKEN 



VARIABLE 




G-19 



GLOSSARY 



VBREAK 

This Is the 6502 BRK Instruction IRQ vector. Whenever a $00 opcode (the 
software break Instruction) Is executed, this Interrupt occurs. VBREAK 
normally points to an RTl Instruction. 



VCOUNT REGISTER 

The ANTIC register which keeps track of which horizontal scan line ANTIC 
Is displaying. 



VDSLST 

Is Is the Display List Interrupt NMI vector located at C$0200, $0201]. 



Th 



VERTICAL BLANK 
microseconds In duration. 



VERTICAL BLANK INTERRUPT 

A non-«.k*l. interrupt .h.eh occurs everv 60th of . »«on< « ^ 



VERTICAL SCROLL ENABLE BIT 



This is bit D5 of the ANTIC display list instruction byte which enabl 
vertical fine scrolling through VSCROL ($D405), the vertical fine sc.o.l 



reg I ster 



VERTICAL SCROLLING 

The orocess of vertical ly "rol I Ing" the display screen "window™ over a 

on the ATARI 400/800. 
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VIMIRQ 

This Is the Immediate IRQ vector. All IRQs vector through this 
location. VIMIRQ normally points to the IRQ handler. This vector can be 
f stolen 1 to do user IRQ Interrupt processing. 



V INTER 



This Is the Peripheral Interrupt IRQ vector. The Interrupt line Is also 
available on the serial bus. VINTER normally points to an RT! Instruction. 



VKEYED 

This Is the keyboard IRQ vector which is activated by pressing any key 
except BREAK . This vector normally points to the OS's own keyboard IRQ 
routine. 



VNTD 

In BASIC, this Is the pointer ([84,85] decimal) to the Variable Name 
Table Dummy end. BASIC uses this pointer to indicate the end of the name 
table. This pointer normally points to a dummy zero byte when there are less 
than 128 variables. When 128 variables are present, this points to the last 
byte of the last variable name. 



VNTP 

In BASIC, the pointer ([82,83] decimal) to the Variable Name Table. 



VFRCED 

This is the Peripheral Proceed IRQ vector. The proceed line is 

available to peripherals on the serial bus. This IRQ Is unused at the 

present and normally points to an RTI Instruction. 



VSCRCL 
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This Is the vertical fine scroll register located at $0405. Into VSCROL 
the user stuffs the number of scan lines by which the screen line Is to be 
vertical ly scrol led. 



VSER I N 

This Is the POKEY serial Input Ready IRQ vectcr 



VSEROR 

This Is the POKEY serial Output Ready IRQ vector 



VT1MR1 

This Is the POKEY timer 1 IRQ vectcr. 



VT1MR2 

This Is the POKEY timer 2 IRQ vectcr. 



VT1MR4 

This Is the POKEY timer 4 IRQ vector. 



VVBLKD 

This Is the Vertical Blank Deferred NMI Interrupt vector located at 
[$0224, $02253. 



VVBLK I 

Thfs Is the Vertical Blank Immediate NMI Interrupt vector located at 
C$0222,50223]. 



VVTP 
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in BASIC, this Is the pointer (£86,87] decimal) to the Variable Value 
Tab I e . 



WARM START 

Another name for SYSTEM RESET which Is similar (In the vector 
Initializing functions) to, but not Identical to, a coldstart. 



WIDE PLAYF I ELD 

A screen display width option equal to a width of 192 color clocks. 



WORK MASTER 

In the mass production of cassette tapes, this Is the final master tape 
from which numerous cassette tapes will actually be manufactured. 



WSYNC 

Walt for Horizontal Sync of the electron beam which Is drawing the 
screen Image, The WSYNC register, when written to In any way, pulls down th 
RDY line on the 6502 microprocessor, freezing the 6502 until the electron 
beam drawing the screen Image returns to the left edge of the screen* 



ZERO-PAGE 

In the ATARI Personal Computer System, this Is the stretch of memory 
which spans locations S0000 to S00FF. 



Z10CS 

Zero-page I/O Control Block — used to communicate I/O control data 
between CIO and the device handlers* 
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